Ações, recursos e chaves de condição do AWS IoT Analytics

AWS O IoT Analytics (prefixo do serviçoiotanalytics:) fornece os seguintes recursos, ações e chaves de contexto de condições específicos do serviço para uso em políticas de permissão. IAM

Referências:

• Saiba como configurar este serviço.

• Veja uma lista das APIoperações disponíveis para esse serviço.

• Saiba como proteger esse serviço e seus recursos usando políticas de IAM permissão.

Ações definidas pelo AWS IoT Analytics

Você pode especificar as seguintes ações no Action elemento de uma declaração de IAM política. Use políticas para conceder permissões para executar uma operação na AWS. Quando você usa uma ação em uma política, geralmente permite ou nega acesso à API operação ou ao CLI comando com o mesmo nome. No entanto, em alguns casos, uma única ação controla o acesso a mais de uma operação. Como alternativa, algumas operações exigem várias ações diferentes.

A coluna Tipos de recursos na tabela Ações indica se cada ação é compatível com permissões no nível do recurso. Se não houver valor para essa coluna, você deverá especificar todos os recursos ("*") aos quais a política se aplica no elemento Resource de sua declaração de política. Se a coluna incluir um tipo de recurso, você poderá especificar um ARN desse tipo em uma declaração com essa ação. Se a ação tiver um ou mais recursos necessários, o chamador deverá ter permissão para usar a ação com esses recursos. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você limitar o acesso aos recursos com o Resource elemento em uma IAM política, deverá incluir um padrão ARN ou para cada tipo de recurso necessário. Algumas ações oferecem suporte a vários tipos de recursos. Se o tipo de recurso for opcional (não indicado como obrigatório), você poderá optar por usar um dos tipos de recurso opcionais.

A coluna Chaves de condição na tabela Ações inclui chaves que você pode especificar em um elemento Condition da declaração de política. Para obter mais informações sobre as chaves de condição associadas aos recursos do serviço, consulte a coluna Chaves de condição da tabela Tipos de recursos.

nota

As chaves de condição do recurso estão listadas na tabela Tipos de recursos. Você pode encontrar um link para o tipo de recurso que se aplica a uma ação na coluna Tipos de recursos (*obrigatório) da tabela Ações. O tipo de recurso na tabela Tipos de recursos inclui a coluna Chaves de condição, que são as chaves de condição do recurso que se aplicam a uma ação na tabela Ações.

Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de ações.

Ações	Descrição	Nível de acesso	Tipos de recursos (*necessários)	Chaves de condição	Ações dependentes
BatchPutMessage	Coloca um lote de mensagens no canal especificado	Escrever	channel*
CancelPipelineReprocessing	Cancela o reprocessamento do pipeline especificado	Escrever	pipeline*
CreateChannel	Cria um canal	Escrever	channel*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDataset	Cria um conjunto de dados	Escrever	dataset*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDatasetContent	Gera o conteúdo do conjunto de dados especificado (executando as ações do conjunto de dados)	Escrever	dataset*
CreateDatastore	Cria um datastore	Escrever	datastore*
				aws:RequestTag/${TagKey} aws:TagKeys
CreatePipeline	Cria um pipeline	Escrever	pipeline*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteChannel	Exclui o canal especificado	Escrever	channel*
DeleteDataset	Exclui o conjunto de dados especificado	Escrever	dataset*
DeleteDatasetContent	Exclui o conteúdo do conjunto de dados especificado	Escrever	dataset*
DeleteDatastore	Exclui o datastore especificado	Escrever	datastore*
DeletePipeline	Exclui o pipeline especificado	Escrever	pipeline*
DescribeChannel	Descreve o canal especificado	Leitura	channel*
DescribeDataset	Descreve o conjunto de dados especificado	Leitura	dataset*
DescribeDatastore	Descreve o datastore especificado	Leitura	datastore*
DescribeLoggingOptions	Descreve as opções de log da conta	Leitura
DescribePipeline	Descreve o pipeline especificado	Leitura	pipeline*
GetDatasetContent	Obtém o conteúdo do conjunto de dados especificado	Leitura	dataset*
ListChannels	Lista os canais da conta	Listar
ListDatasetContents	Lista informações sobre o conteúdo do conjunto de dados que foi criado	Listar	dataset*
ListDatasets	Lista os conjuntos de dados da conta	Listar
ListDatastores	Lista os datastores da conta	Listar
ListPipelines	Lista os pipelines da conta	Listar
ListTagsForResource	Lista as etiquetas (metadados) que você atribuiu ao recurso	Leitura	channel
			dataset
			datastore
			pipeline
PutLoggingOptions	Coloca as opções de log da conta	Escrever
RunPipelineActivity	Executa a atividade do pipeline especificado	Leitura
SampleChannelData	Amostra os dados do canal especificado	Leitura	channel*
StartPipelineReprocessing	Inicia o reprocessamento do pipeline especificado	Escrever	pipeline*
TagResource	Adiciona ou modifica as etiquetas do determinado recurso. Etiquetas são metadados que podem ser usados para gerenciar um recurso	Tags	channel
			dataset
			datastore
			pipeline
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Remove as etiquetas determinadas (metadados) do recurso	Tags	channel
			dataset
			datastore
			pipeline
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateChannel	Atualiza o canal especificado	Escrever	channel*
UpdateDataset	Atualiza o conjunto de dados especificado	Escrever	dataset*
UpdateDatastore	Atualiza o datastore especificado	Escrever	datastore*
UpdatePipeline	Atualiza o pipeline especificado	Escrever	pipeline*

Tipos de recursos definidos pelo AWS IoT Analytics

Os tipos de recursos a seguir são definidos por esse serviço e podem ser usados no Resource elemento das declarações de política de IAM permissão. Cada ação na Tabela de ações identifica os tipos de recursos que podem ser especificados com essa ação. Um tipo de recurso também pode definir quais chaves de condição você pode incluir em uma política. Essas chaves são exibidas na última coluna da tabela Tipos de recursos. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.

Tipos de recursos	ARN	Chaves de condição
channel	arn:${Partition}:iotanalytics:${Region}:${Account}:channel/${ChannelName}	aws:RequestTag/${TagKey} aws:TagKeys iotanalytics:ResourceTag/${TagKey}
dataset	arn:${Partition}:iotanalytics:${Region}:${Account}:dataset/${DatasetName}	aws:RequestTag/${TagKey} aws:TagKeys iotanalytics:ResourceTag/${TagKey}
datastore	arn:${Partition}:iotanalytics:${Region}:${Account}:datastore/${DatastoreName}	aws:RequestTag/${TagKey} aws:TagKeys iotanalytics:ResourceTag/${TagKey}
pipeline	arn:${Partition}:iotanalytics:${Region}:${Account}:pipeline/${PipelineName}	aws:RequestTag/${TagKey} aws:TagKeys iotanalytics:ResourceTag/${TagKey}

Chaves de condição do AWS IoT Analytics

AWS O IoT Analytics define as seguintes chaves de condição que podem ser usadas Condition no elemento de IAM uma política. É possível usar essas chaves para refinar ainda mais as condições sob as quais a declaração de política se aplica. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de chaves de condição.

Para ver as chaves de condição globais que estão disponíveis para todos os serviços, consulte Chaves de condição globais disponíveis.

Chaves de condição	Descrição	Type
aws:RequestTag/${TagKey}	Filtra ações com base nas etiquetas transmitidas na solicitação	String
aws:TagKeys	Filtra o acesso com base na presença de chaves da etiqueta na solicitação	ArrayOfString
iotanalytics:ResourceTag/${TagKey}	Filtra o acesso por pares chave-valor da etiqueta anexados ao recurso	String