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á.

AWS IoT SiteWise políticas baseadas em identidade

IAMas políticas permitem que você controle quem pode fazer o quê AWS IoT SiteWise. Você pode decidir quais ações são permitidas ou não e definir condições específicas para essas ações. Por exemplo, você pode criar regras sobre quem pode ver ou alterar as informações AWS IoT SiteWise. AWS IoT SiteWise oferece suporte a ações, recursos e chaves de condição específicos. Para saber mais sobre todos os elementos que você usa em uma JSON política, consulte a referência IAM JSON de elementos de política no Guia IAM do usuário.

Ações das políticas

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos, e em que condições.

O Action elemento de uma JSON política descreve as ações que você pode usar para permitir ou negar acesso em uma política. As ações de política geralmente têm o mesmo nome da AWS API operação associada. Há algumas exceções, como ações somente com permissão que não têm uma operação correspondente. API Algumas operações também exigem várias ações em uma política. Essas ações adicionais são chamadas de ações dependentes.

Incluem ações em uma política para conceder permissões para executar a operação associada.

As ações políticas AWS IoT SiteWise usam o seguinte prefixo antes da ação:iotsitewise:. Por exemplo, para conceder permissão a alguém para carregar dados da propriedade do ativo AWS IoT SiteWise com a BatchPutAssetPropertyValue API operação, você inclui a iotsitewise:BatchPutAssetPropertyValue ação na política dessa pessoa. As declarações de política devem incluir um NotAction elemento Action ou. AWS IoT SiteWise define seu próprio conjunto de ações que descrevem as tarefas que você pode executar com esse serviço.

Para especificar várias ações em uma única declaração, separe-as com vírgulas, conforme a seguir.

"Action": [
  "iotsitewise:action1",
  "iotsitewise:action2"
]

Você também pode especificar várias ações utilizando caracteres curinga (*). Por exemplo, para especificar todas as ações que começam com a palavra Describe, inclua a ação a seguir:

"Action": "iotsitewise:Describe*"

Para ver uma lista de AWS IoT SiteWise ações, consulte Ações definidas por AWS IoT SiteWise no Guia do IAM usuário.

BatchPutAssetPropertyValue autorização

AWS IoT SiteWise autoriza o acesso à BatchPutAssetPropertyValueação de uma forma incomum. Para a maioria das ações, quando você permite ou nega acesso, essa ação retorna um erro se as permissões não forem concedidas. ComBatchPutAssetPropertyValue, você pode enviar várias entradas de dados para diferentes ativos e propriedades de ativos em uma única API solicitação. AWS IoT SiteWise autoriza cada entrada de dados de forma independente. Para qualquer entrada individual que falhe na autorização na solicitação, AWS IoT SiteWise inclua um AccessDeniedException na lista de erros retornada. AWS IoT SiteWise recebe os dados de qualquer entrada autorizada e bem-sucedida, mesmo que outra entrada na mesma solicitação falhe.

Atributos de políticas

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos, e em que condições.

O elemento Resource JSON de política especifica o objeto ou objetos aos quais a ação se aplica. As instruções devem incluir um elemento Resource ou NotResource. Como prática recomendada, especifique um recurso usando seu Amazon Resource Name (ARN). Isso pode ser feito para ações que oferecem compatibilidade com um tipo de recurso específico, conhecido como permissões em nível de recurso.

Para ações que não oferecem compatibilidade com permissões em nível de recurso, como operações de listagem, use um curinga (*) para indicar que a instrução se aplica a todos os recursos.

"Resource": "*"

Cada declaração IAM de política se aplica aos recursos que você especifica usando seusARNs. An ARN tem a seguinte sintaxe geral.

arn:${Partition}:${Service}:${Region}:${Account}:${ResourceType}/${ResourcePath}

Para obter mais informações sobre o formato deARNs, consulte Amazon Resource Names (ARNs) e namespaces AWS de serviços.

Por exemplo, para especificar o ativo com ID a1b2c3d4-5678-90ab-cdef-22222EXAMPLE em sua declaração, use o seguinteARN. ;

"Resource": "arn:aws:iotsitewise:region:123456789012:asset/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"

Para especificar todos os fluxos de dados que pertencem a uma conta específica, use o caractere curinga (*):

"Resource": "arn:aws:iotsitewise:region:123456789012:time-series/*"

Para especificar todos os ativos que pertencem a uma conta específica, use o caractere curinga (*):

"Resource": "arn:aws:iotsitewise:region:123456789012:asset/*"

Algumas AWS IoT SiteWise ações, como as de criação de recursos, não podem ser executadas em um recurso específico. Nesses casos, você deve utilizar o caractere curinga (*).

"Resource": "*"

Para especificar vários recursos em uma única instrução, separe-os ARNs com vírgulas.

"Resource": [
  "resource1",
  "resource2"
]

Para ver uma lista dos tipos de AWS IoT SiteWise recursos e seusARNs, consulte Recursos definidos por AWS IoT SiteWise no Guia do IAM usuário. Para saber com quais ações você pode especificar cada recurso, consulte Ações definidas por AWS IoT SiteWise. ARN

Chaves de condição de políticas

Os administradores podem usar AWS JSON políticas para especificar quem tem acesso ao quê. Ou seja, qual entidade principal pode executar ações em quais recursos, e em que condições.

O elemento Condition (ou bloco Condition) permite que você especifique condições nas quais uma instrução estiver em vigor. O elemento Condition é opcional. É possível criar expressões condicionais que usem agentes de condição, como “igual a” ou “menor que”, para fazer a condição da política corresponder aos valores na solicitação.

Se você especificar vários elementos Condition em uma instrução ou várias chaves em um único Condition elemento, a AWS os avaliará usando uma operação lógica AND. Se você especificar vários valores para uma única chave de condição, AWS avalia a condição usando uma OR operação lógica. Todas as condições devem ser atendidas antes que as permissões da instrução sejam concedidas.

Você também pode usar variáveis de espaço reservado ao especificar condições. Por exemplo, você pode conceder permissão a um IAM usuário para acessar um recurso somente se ele estiver marcado com o nome de IAM usuário. Para obter mais informações, consulte elementos de IAM política: variáveis e tags no Guia IAM do usuário.

AWS suporta chaves de condição globais e chaves de condição específicas do serviço. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia IAM do usuário.

AWS IoT SiteWise define seu próprio conjunto de chaves de condição e também oferece suporte ao uso de algumas chaves de condição globais. Para ver todas as chaves de condição AWS globais, consulte as chaves de contexto de condição AWS global no Guia IAM do usuário.

Para saber com quais ações e recursos você pode usar uma chave de condição, consulte Ações definidas por AWS IoT SiteWise.

Exemplos

Para ver exemplos de políticas AWS IoT SiteWise baseadas em identidade, consulte. AWS IoT SiteWise exemplos de políticas baseadas em identidade