Identificar los recursos con AWS Cloud Control API - Control en la nube API

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Identificar los recursos con AWS Cloud Control API

Cada tipo de recurso tiene una propiedad que se define como su identificador principal. El valor de esta propiedad debe ser único para cada recurso de ese tipo en una Cuenta de AWS y determinada Región de AWS. Por ejemplo, muchos tipos de recursos incluyen una propiedad Name que debe ser única para cada recurso de ese tipo. En algunos casos, el identificador principal se define como una combinación de varias propiedades que juntas forman un identificador único. Al usar este identificador principal, combinado con el tipo de recurso, puede especificar exactamente en qué recurso desea realizar operaciones de recursos, como update-resource o delete-resource.

Además, algunos tipos de recursos definen identificadores secundarios que también se pueden usar para identificar de forma exclusiva los recursos de ese tipo.

Para determinar qué propiedad (o combinación de propiedades) del recurso es el identificador principal de un tipo de recurso, consulte el atributo primaryIdentifier del esquema de tipos de recursos. El esquema también incluye los identificadores secundarios definidos. Para obtener más información, consulte Visualización de esquemas de tipos de recursos.

Obtención del identificador principal de un recurso

Puedes encontrar el valor del identificador de un recurso específico mediante los API comandos de Cloud Control. Cada uno de los siguientes comandos devuelve un objeto ProgressEvent que contiene el identificador principal de los recursos especificados:

  • cancel-resource-request
  • create-resource
  • get-resource-request-status
  • list-resource-requests

Uso del identificador principal de un recurso

Al usar API los comandos de Cloud Control, puedes especificar el identificador principal o cualquier identificador secundario definido para el tipo de recurso en su esquema de recursos. Solo puede especificar un identificador. Los identificadores principales se pueden especificar como una cadena oJSON; los identificadores secundarios se deben especificar como. JSON

En el caso de los identificadores principales compuestos (es decir, aquellos que constan de varias propiedades de recursos agrupadas), para especificar el identificador principal como una cadena, enumere los valores de las propiedades en el orden en que se especifican en la definición del identificador principal, separados por |.

Por ejemplo, el identificador principal del recurso se define como:

"primaryIdentifier": [ "/properties/DatabaseName", "/properties/TableName" ]

Por lo tanto, para especificar el identificador principal de un recurso como una cadena, utilice el siguiente formato.

DatabaseName|TableName

Por ejemplo, si se trata de una base de datos con nombre de base de datos MyDatabase y nombre de tabla MyTable, especifique MyDatabase|MyTable.

Para los identificadores compuestos especificados comoJSON, no es necesario ordenar las propiedades, como se muestra en el siguiente ejemplo.

{ "TableName": "MyTable", "DatabaseName": "MyDatabase" }

Para obtener más información sobre los identificadores de recursos, consulte primaryidentifier en la interfaz de línea de CloudFormation comandos User Move for Extension Development.