Como identificar recursos - API de controle de nuvem do

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como identificar recursos

Cada tipo de recurso tem uma propriedade definida como suaIdentificador primário. O valor dessa propriedade deve ser exclusivo para cada recurso desse tipo em um determinadoConta da AWSeRegião da AWS. Por exemplo, muitos tipos de recursos incluem umNamePropriedade que deve ser exclusiva para cada recurso desse tipo. Em alguns casos, o identificador primário é definido como uma combinação de várias propriedades que juntas formam um identificador exclusivo. Ao usar esse identificador primário, combinado com o tipo de recurso, você pode especificar exatamente qual recurso deseja executar operações de recursos, comoupdate-resourceoudelete-resource.

Além disso, alguns tipos de recursos definemIdentificadores secundáriosEsse tipo também pode ser usado para identificar exclusivamente recursos desse tipo.

Para determinar qual propriedade de recurso (ou combinação de propriedades) é o identificador principal de um tipo de recurso, consulte aprimaryIdentifieratributo do esquema de tipo de recurso. O esquema também inclui identificadores secundários definidos. Para obter mais informações, consulteExibindo esquemas de tipo de recurso.

Obtendo o identificador principal de um recurso

Você pode encontrar o identificadorvalorpara um recurso específico usando comandos da Cloud Control API. Cada um dos comandos a seguir retorna umProgressEventobjeto que contém o identificador principal dos recursos especificados:

  • cancel-resource-request

  • create-resource

  • get-resource-request-status

  • list-resource-requests

Usando o identificador principal de um recurso

Ao usar comandos da Cloud Control API, você pode especificar o identificador primário ou qualquer identificador secundário definido para o tipo de recurso em seu esquema de recursos. É possível especificar somente um identificador. Identificadores primários podem ser especificados como uma string ou JSON; identificadores secundários devem ser especificados como JSON.

Para identificadores primários compostos (ou seja, um que consiste em várias propriedades de recursos unidas), para especificar o identificador primário como uma string, liste os valores de propriedadena ordem em que são especificadasna definição do identificador primário, separada por|.

Por exemplo, o identificador principal darecurso é definido como:

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

Então, para especificar o identificador primário de umrecurso como uma string, você usa o seguinte formato.

DatabaseName|TableName

Por exemplo, dado um banco de dados com um nome de banco de dados deMyDatabasee nome da tabela deMyTable, você especificaMyDatabase|MyTable.

Para identificadores compostos especificados como JSON, a ordem de propriedade não é necessária, como mostrado no exemplo a seguir.

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

Para obter mais informações sobre identificadores de recursos, consulteprimaryidentifiernoGuia do usuário da interface de linha de comando do CloudFormation para desenvolvimento de extensões.