Como identificar recursos - Control API do Cloud Control

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 que é 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. Usando esse identificador primário, combinado com o tipo de recurso, você pode especificar exatamente em qual recurso deseja executar operações de recurso, comoupdate-resourceoudelete-resource.

Além disso, alguns tipos de recursos definemIdentificadores secundários doque 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 do tipo de recurso. O esquema também inclui identificadores secundários definidos. Para obter mais informações, consulteExibindo esquemas de tipo de recurso.

Como obter o identificador primário de um recurso

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

  • cancel-resource-request

  • create-resource

  • get-resource-request-status

  • list-resource-requests

Usando o identificador primário de um recurso

Ao usar os 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. Só é possível especificar um identificador. Os 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 recurso agrupadas), para especificar o identificador primário como uma string, liste os valores da propriedadena ordem em que são especificadasna definição do identificador primário, separado por|.

Por exemplo, o identificador primário daresource é definido como:

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

Então, para especificar o identificador primário de umresource 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 recurso, consulteidentificador primárionoCloudFormation Manual do usuário da interface de linha de comando para desenvolvimento de extensões.