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á.
Identificação de recursos com AWS Cloud Control API
Cada tipo de recurso tem uma propriedade que é definida como seu identificador principal. O valor dessa propriedade deve ser exclusivo para cada recurso desse tipo em um determinado Conta da AWS Região da AWS e. Por exemplo, muitos tipos de recursos incluem uma propriedade Name
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 em qual recurso deseja realizar operações de recursos, como update-resource
ou delete-resource
.
Além disso, alguns tipos de recursos definem identificadores secundários que também podem ser usados para identificar exclusivamente recursos desse tipo.
Para determinar qual propriedade do recurso (ou combinação de propriedades) é o identificador principal de um tipo de recurso, consulte o atributo primaryIdentifier
do esquema do tipo de recurso. O esquema também inclui identificadores secundários definidos. Para obter mais informações, consulte Visualizando esquemas de tipos de recursos.
Obtendo o identificador primário de um recurso
Você pode encontrar o valor do identificador de um recurso específico usando os API comandos do Cloud Control. Cada um dos seguintes comandos retorna um objeto ProgressEvent
que contém o identificador primário dos recursos especificados:
-
cancel-resource-request
-
create-resource
-
get-resource-request-status
-
list-resource-requests
Utilizando o identificador primário de um recurso
Ao usar API os comandos do Cloud Control, 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 ouJSON; os identificadores secundários devem ser especificados como. JSON
Para identificadores primários compostos (ou seja, aqueles que consistem em várias propriedades de recursos agrupadas), para especificar o identificador primário como uma string, liste os valores da propriedade na ordem em que foram especificados na definição do identificador primário, separados por |
.
Por exemplo, o identificador primário do recurso é definido como:
"primaryIdentifier": [ "/properties/DatabaseName", "/properties/TableName" ]
Portanto, para especificar o identificador primário de um recurso como uma string, use o formato a seguir.
DatabaseName|TableName
Por exemplo, dado um banco de dados com um nome de banco de dados MyDatabase
e nome de tabela de MyTable
, você especifica MyDatabase|MyTable
.
Para identificadores compostos especificados comoJSON, a ordem da propriedade não é necessária, conforme mostrado no exemplo a seguir.
{ "TableName": "MyTable", "DatabaseName": "MyDatabase" }
Para obter mais informações sobre identificadores de recursos, consulte primaryidentifier na interface de linha de CloudFormation comando User Move for Extension Development.