단일 기능 가져오기

const feature = appConfigClient.getFeature('feature_id'); // feature can be null incase of an invalid feature id

if (feature !== null) {
   console.log(`Feature Name ${feature.getFeatureName()} `);
   console.log(`Feature Id ${feature.getFeatureId()} `);
   console.log(`Feature Type ${feature.getFeatureDataType()} `);
   if (feature.isEnabled()) {
      // feature flag is enabled
   } else {
      // feature flag is disabled
   }
}

모든 기능 가져오기

const features = appConfigClient.getFeatures();
const feature = features['feature_id'];

if (feature !== null) {
   console.log(`Feature Name ${feature.getFeatureName()} `);
   console.log(`Feature Id ${feature.getFeatureId()} `);
   console.log(`Feature Type ${feature.getFeatureDataType()} `);
   console.log(`Is feature enabled? ${feature.isEnabled()} `);
}

기능 평가

feature.getCurrentValue(entityId, entityAttributes) 메소드를 사용하여 기능 플래그의 값을 평가할 수 있습니다. 이 메소드는 평가된 값, 기능 플래그 사용 상태 및 평가 세부사항을 포함하는 JSON 오브젝트를 리턴합니다.

const entityId = '<entityId>';
const entityAttributes = {
  city: 'Bangalore',
  country: 'India',
};

const result = feature.getCurrentValue(entityId, entityAttributes);
console.log(result.value); // Evaluated value of the feature flag. The type of evaluated value will match the type of feature flag (Boolean, String, Numeric).
console.log(result.isEnabled); // enabled status.
console.log(result.details); // a JSON object containing detailed information of the evaluation.

// the `result.details` will have the following
console.log(result.details.valueType); // a string value. Example: DISABLED_VALUE
console.log(result.details.reason); // a string value. Example: Disabled value of the feature flag since the feature flag is disabled.
console.log(result.details.segmentName); // (only if applicable, else it is undefined) a string value containing the segment name for which the feature flag was evaluated.
console.log(result.details.rolloutPercentageApplied); // (only if applicable, else it is undefined) a boolean value. True if the entityId was part of the rollout percentage evaluation, false otherwise.
console.log(result.details.errorType); // (only if applicable, else it is undefined) contains the error.message if any error was occured during the evaluation.

• entityId: 엔티티의 ID입니다. 기능이 평가되는 엔티티와 관련된 문자열 ID입니다. 예를 들어 엔티티는 모바일 디바이스에서 실행되는 앱, 클라우드에서 실행되는 마이크로서비스 또는 해당 마이크로서비스를 실행하는 인프라 컴포넌트의 인스턴스일 수 있습니다. 엔티티가 App Configuration와 상호동작하려면 고유한 엔티티 ID를 제공해야 합니다.

• entityAttributes: 지정된 엔티티를 정의하는 속성 이름 및 해당 값으로 구성되는 JSON 오브젝트입니다. 기능 플래그가 대상 정의로 구성되지 않은 경우 이는 선택적 매개변수입니다. 대상이 구성된 경우 규칙 평가를 위해 entityAttributes 를 제공해야 합니다. 속성은 세그먼트를 정의하는 데 사용되는 매개변수입니다. SDK는 속성 값을 사용하여 지정된 엔티티가 대상 규칙을 충족하는지 여부를 판별하고 적절한 기능 플래그 값을 리턴합니다.

단일 특성 가져오기

const property = appConfigClient.getProperty('property_id'); // property can be null incase of an invalid property id

if (property != null) {
  console.log(`Property Name ${property.getPropertyName()} `);
  console.log(`Property Id ${property.getPropertyId()} `);
  console.log(`Property Type ${property.getPropertyDataType()} `);
}

모든 특성 가져오기

const properties = appConfigClient.getProperties();
const property = properties['property_id'];

if (property != null) {
  console.log(`Property Name ${property.getPropertyName()} `);
  console.log(`Property Id ${property.getPropertyId()} `);
  console.log(`Property Type ${property.getPropertyDataType()} `);
}

특성 평가

property.getCurrentValue(entityId, entityAttributes) 메소드를 사용하여 특성 값을 평가할 수 있습니다. 이 메소드는 평가된 값 및 평가 세부사항을 포함하는 JSON 오브젝트를 리턴합니다.

const entityId = '<entityId>';
const entityAttributes = {
  city: 'Bangalore',
  country: 'India',
};

const result = property.getCurrentValue(entityId, entityAttributes);
console.log(result.value); // Evaluated value of the property. The type of evaluated value will match the type of property (Boolean, String, Numeric).
console.log(result.details); // a JSON object containing detailed information of the evaluation. See below

// the `result.details` will have the following
console.log(result.details.valueType); // a string value. Example: DEFAULT_VALUE
console.log(result.details.reason); // a string value. Example: Default value of the property.
console.log(result.details.segmentName); // (only if applicable, else it is undefined) a string value containing the segment name for which the property was evaluated.
console.log(result.details.errorType); // (only if applicable, else it is undefined) contains the error.message if any error was occured during the evaluation.

• entityId: 엔티티의 ID입니다. 특성이 평가되는 엔티티와 관련된 문자열 ID입니다. 예를 들어 엔티티는 모바일 디바이스에서 실행되는 앱, 클라우드에서 실행되는 마이크로서비스 또는 해당 마이크로서비스를 실행하는 인프라 컴포넌트의 인스턴스일 수 있습니다. 엔티티가 App Configuration와 상호동작하려면 고유한 엔티티 ID를 제공해야 합니다.

• entityAttributes: 지정된 엔티티를 정의하는 속성 이름 및 해당 값으로 구성되는 JSON 오브젝트입니다. 특성이 대상 정의로 구성되지 않은 경우 이는 선택적 매개변수입니다. 대상이 구성된 경우 규칙 평가를 위해 entityAttributes 를 제공해야 합니다. 속성은 세그먼트를 정의하는 데 사용되는 매개변수입니다. SDK는 속성 값을 사용하여 지정된 엔티티가 대상 지정 규칙을 충족하는지 여부를 판별하고 적절한 특성 값을 리턴합니다.

시크릿 특성 가져오기

App Configuration에 저장된 시크릿 참조를 가져오기 위한 명시적 메소드입니다.

const secretPropertyObject = appConfigClient.getSecret(propertyId, secretsManagerObject);

여기서,

• propertyID: propertyID 는 고유한 문자열 ID입니다. 이를 사용하면 시크릿을 페치하는 데 필요한 데이터를 제공하는 특성을 페치할 수 있습니다.

• secretsManagerObject: secretsManagerObject 는 시크릿 특성 평가 중 시크릿을 가져오는 데 사용되는 Secrets Manager 클라이언트 오브젝트입니다. Secrets Manager 클라이언트 오브젝트를 작성하는 방법에 대한 자세한 정보는 여기를 참조하십시오.

시크릿 특성 평가

secretPropertyObject.getCurrentValue(entityId, entityAttributes) 메소드를 사용하여 시크릿 특성의 값을 평가하십시오. 이 메소드 호출의 출력은 기능 및 특성 오브젝트를 사용하여 시작된 getCurrentValue 와 다릅니다. 이 메소드는 Secrets Manager 의 응답으로 분석되거나 오류로 거부되는 Promise를 리턴합니다. 해석된 값은 평가된 시크릿 참조의 실제 시크릿 값입니다. 응답에는 본문, 헤더, 상태 코드 및 상태 텍스트가 포함됩니다. 비동기 또는 대기를 사용하는 경우, 오류 처리를 위해 try 또는 catch를 사용하십시오.

const entityId = 'john_doe';
const entityAttributes = {
   city: 'Bangalore',
   country: 'India',
};
try {
   const res = await secretPropertyObject.getCurrentValue(entityId, entityAttributes);
   console.log(JSON.stringify(res, null, 2)); // view entire response.
   console.log('Resulting secret:\n', res.result.resources[0].secret_data.payload); // the actual secret value.
} catch (err) {
   // handle the error
}

여기서,

• entityId: entityId 는 특성이 평가되는 엔티티와 관련된 문자열 ID입니다. 예를 들어, 엔티티는 모바일 기기에서 실행되는 애플리케이션의 인스턴스일 수도 있고, 클라우드에서 실행되는 마이크로서비스일 수도 있으며, 해당 마이크로서비스를 실행하는 인프라의 구성 요소일 수도 있습니다. 엔티티가 App Configuration와 상호동작하려면 고유한 엔티티 ID를 제공해야 합니다.

• entityAttributes: entityAttributes 는 지정된 엔티티를 정의하는 속성 이름 및 해당 값으로 구성된 map[string]interface{} 유형의 맵입니다. 특성이 대상 정의로 구성되지 않은 경우 이는 선택적 매개변수입니다. 대상이 구성된 경우 규칙 평가를 위해 entityAttributes 를 제공해야 합니다. 속성은 세그먼트를 정의하는 데 사용되는 매개변수입니다. SDK는 속성 값을 사용하여 지정된 엔티티가 대상 규칙을 충족하는지 여부를 판별하고 적절한 값을 리턴합니다.