Einzelnes Feature abrufen

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
   }
}

Alle Features abrufen

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-Auswertung

Sie können die Methode feature.getCurrentValue(entityId, entityAttributes) verwenden, um den Wert des Feature-Flags zu bewerten. Diese Methode gibt ein JSON-Objekt mit ausgewerteten Werten, aktiviertem Status des Feature-Flags und Bewertungsdetails zurück.

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 der Entität. Dies ist eine Zeichenfolgekennung, die sich auf die Entität bezieht, für die das Feature ausgewertet wird. Eine Entität kann beispielsweise eine Instanz einer App sein, die auf einem mobilen Gerät ausgeführt wird, einen Mikroservice, der in der Cloud ausgeführt wird, oder eine Komponente der Infrastruktur, die diesen Mikroservice ausführt. Damit eine Entität mit App Configuration interagieren kann, muss sie eine eindeutige Entitäts-ID angeben

• entityAttributes: Ein JSON-Objekt, das aus dem Attributnamen und ihren Werten besteht, die die angegebene Entität definieren. Dies ist ein optionaler Parameter, wenn das Feature-Flag nicht mit einer Zieldefinition konfiguriert ist. Wenn das Ziel konfiguriert ist, sollte entityAttributes für die Regelauswertung angegeben werden. Ein Attribut ist ein Parameter, der zum Definieren eines Segments verwendet wird. Das SDK verwendet die Attributwerte, um festzustellen, ob die angegebene Entität die Zielregeln erfüllt, und gibt den entsprechenden Feature-Flag-Wert zurück.

Einzeleigenschaft abrufen

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()} `);
}

Alle Eigenschaften abrufen

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()} `);
}

Eigenschaft auswerten

Sie können die Methode property.getCurrentValue(entityId, entityAttributes) verwenden, um den Wert der Eigenschaft auszuwerten. Diese Methode gibt ein JSON-Objekt mit ausgewerteten Werten und Auswertungsdetails zurück.

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 der Entität. Dies ist eine Zeichenfolgekennung, die sich auf die Entität bezieht, für die die Eigenschaft ausgewertet wird. Eine Entität kann beispielsweise eine Instanz einer App sein, die auf einem mobilen Gerät ausgeführt wird, einen Mikroservice, der in der Cloud ausgeführt wird, oder eine Komponente der Infrastruktur, die diesen Mikroservice ausführt. Damit eine Entität mit App Configuration interagieren kann, muss sie eine eindeutige Entitäts-ID angeben

• entityAttributes: Ein JSON-Objekt, das aus dem Attributnamen und ihren Werten besteht, die die angegebene Entität definieren. Dies ist ein optionaler Parameter, wenn die Eigenschaft nicht mit einer Zieldefinition konfiguriert ist. Wenn das Ziel konfiguriert ist, sollte entityAttributes für die Regelauswertung angegeben werden. Ein Attribut ist ein Parameter, der zum Definieren eines Segments verwendet wird. Das SDK verwendet die Attributwerte, um zu bestimmen, ob die angegebene Entität die Zielregeln erfüllt, und gibt den entsprechenden Eigenschaftswert zurück.

Eigenschaft für geheimen Schlüssel abrufen

Explizite Methode zum Abrufen der in App Configurationgespeicherten Referenzen auf geheime Schlüssel.

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

Dabei gilt Folgendes:

• propertyID: propertyID ist die eindeutige Zeichenfolge-ID, mit der Sie die Eigenschaft abrufen können, die die erforderlichen Daten zum Abrufen des geheimen Schlüssels bereitstellt.

• secretsManagerObject: secretsManagerObject ist ein Secrets Manager-Clientobjekt, das zum Abrufen der geheimen Schlüssel während der Auswertung der Eigenschaft für geheime Schlüssel verwendet wird. Weitere Informationen zum Erstellen eines Secrets Manager-Clientobjekts finden Sie hier.

Eigenschaft für geheimen Schlüssel auswerten

Verwenden Sie die Methode secretPropertyObject.getCurrentValue(entityId, entityAttributes), um den Wert der Eigenschaft für geheime Schlüssel auszuwerten. Die Ausgabe dieses Methodenaufrufs unterscheidet sich von der Ausgabe von getCurrentValue, die mithilfe von Feature-und Eigenschaftenobjekten gestartet wurde. Diese Methode gibt ein Promise zurück, das mit der Antwort von Secrets Manager aufgelöst oder mit einem Fehler zurückgewiesen wird. Der aufgelöste Wert ist der tatsächliche Wert des geheimen Schlüssels der Referenz des ausgewerteten geheimen Schlüssels. Die Antwort enthält den Hauptteil, die Header, den Statuscode und den Statustext. Wenn Sie 'async' oder 'wait' verwenden, verwenden Sie 'try' oder 'catch' zur Behandlung von Fehlern.

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
}

Dabei gilt Folgendes:

• entityId: entityId ist eine Zeichenfolgekennung, die sich auf die Entität bezieht, für die die Eigenschaft ausgewertet wird. Eine Entität kann beispielsweise eine Instanz einer Anwendung sein, die auf einem mobilen Gerät ausgeführt wird, ein Microservice, der in der Cloud ausgeführt wird, oder eine Infrastrukturkomponente, auf der dieser Microservice ausgeführt wird. Damit eine Entität mit App Configuration interagieren kann, muss sie eine eindeutige Entitäts-ID angeben

• entityAttributes: entityAttributes ist eine Zuordnung des Typs map[string]interface{}, die aus dem Attributnamen und ihren Werten besteht, die die angegebene Entität definieren. Dies ist ein optionaler Parameter, wenn die Eigenschaft nicht mit einer Zieldefinition konfiguriert ist. Wenn das Ziel konfiguriert ist, sollte entityAttributes für die Regelauswertung angegeben werden. Ein Attribut ist ein Parameter, der zum Definieren eines Segments verwendet wird. Das SDK verwendet die Attributwerte, um festzustellen, ob die angegebene Entität die Zielregeln erfüllt, und gibt den entsprechenden Wert zurück.