Ações, recursos e chaves de condição do AWS IoT SiteWise - Referência de autorização do serviço

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

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

Referências:

Ações definidas pelo AWS IoT SiteWise

Você pode especificar as seguintes ações no elemento Action de uma declaração de política do IAM. Use políticas para conceder permissões para executar uma operação na AWS. Quando usa uma ação em uma política, você geralmente permite ou nega acesso à operação da API ou ao comando da CLI 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 Resource types (Tipos de recursos) 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 ("*") 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. Os recursos obrigatórios são indicados na tabela com um asterisco (*). Se você especificar um ARN de permissão no nível do recurso em uma instrução que esteja usando essa ação, ele deverá ser desse tipo. 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, mas não o outro.

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
AssociateAssets Concede permissão para associar um ativo filho a um ativo pai por uma hierarquia Write

asset*

AssociateTimeSeriesToAssetProperty Concede permissão para associar uma série temporal a uma propriedade de ativo Write

asset*

time-series*

BatchAssociateProjectAssets Concede permissão para associar ativos a um projeto Write

project*

BatchDisassociateProjectAssets Concede permissão para desassociar ativos de um projeto Write

project*

BatchGetAssetPropertyAggregates Concede permissão para recuperar agregados computados para várias propriedades do ativo Read

asset

time-series

BatchGetAssetPropertyValue Concede permissão para recuperar o valor mais recente de várias propriedades do ativo Read

asset

time-series

BatchGetAssetPropertyValueHistory Concede permissão para recuperar o histórico do valor de várias propriedades do ativo Read

asset

time-series

BatchPutAssetPropertyValue Concede permissão para colocar valores de propriedade para propriedades de ativos Write

asset

time-series

CreateAccessPolicy Concede permissão para criar uma política de acesso para um portal ou um projeto Write

portal

project

aws:RequestTag/${TagKey}

aws:TagKeys

CreateAsset Concede permissão para criar um ativo usando um modelo de ativo Write

asset-model*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateAssetModel Concede permissão para criar um modelo de ativo Write

aws:RequestTag/${TagKey}

aws:TagKeys

CreateBulkImportJob Concede permissão para criar um trabalho de importação em massa Write
CreateDashboard Concede permissão para criar um painel em um projeto Write

project*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateGateway Concede permissão para criar um gateway Write

aws:RequestTag/${TagKey}

aws:TagKeys

CreatePortal Concede permissão para criar um portal Write

aws:RequestTag/${TagKey}

aws:TagKeys

sso:CreateManagedApplicationInstance

sso:DescribeRegisteredRegions

CreateProject Concede permissão para criar um projeto em um portal Write

portal*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteAccessPolicy Concede permissão para excluir uma política de acesso Write

access-policy*

DeleteAsset Concede permissão para excluir um ativo Write

asset*

DeleteAssetModel Concede permissão para excluir um modelo de ativo Write

asset-model*

DeleteDashboard Concede permissão para excluir um painel Write

dashboard*

DeleteGateway Concede permissão para excluir um gateway Write

gateway*

DeletePortal Concede permissão para excluir um portal Write

portal*

sso:DeleteManagedApplicationInstance

DeleteProject Concede permissão para excluir um projeto Write

project*

DeleteTimeSeries Concede permissão para excluir uma série temporal Write

asset

time-series

DescribeAccessPolicy Concede permissão para descrever uma política de acesso Read

access-policy*

DescribeAsset Concede permissão para descrever um ativo Read

asset*

DescribeAssetModel Concede permissão para descrever um modelo de ativo Read

asset-model*

DescribeAssetProperty Concede permissão para descrever uma propriedade de ativo Read

asset*

DescribeBulkImportJob Concede permissão para descrever um trabalho de importação em massa Read
DescribeDashboard Concede permissão para descrever um painel Read

dashboard*

DescribeDefaultEncryptionConfiguration Concede permissão para descrever a configuração padrão de criptografia da Conta da AWS Read
DescribeGateway Concede permissão para descrever um gateway Read

gateway*

DescribeGatewayCapabilityConfiguration Concede permissão para descrever uma configuração de capacidade para um gateway Read

gateway*

DescribeLoggingOptions Concede permissão para descrever opções de log da Conta da AWS Read
DescribePortal Concede permissão para descrever um portal Read

portal*

DescribeProject Concede permissão para descrever um projeto Read

project*

DescribeStorageConfiguration Concede permissão para descrever a configuração de armazenamento para a Conta da AWS Read
DescribeTimeSeries Concede permissão para descrever uma série temporal Read

asset

time-series

DisassociateAssets Concede permissão para desassociar um ativo filho de um ativo pai por uma hierarquia Write

asset*

DisassociateTimeSeriesFromAssetProperty Concede permissão para desassociar uma série temporal de uma propriedade de ativo Write

asset*

time-series*

GetAssetPropertyAggregates Concede permissão para recuperar agregados computados para uma propriedade de ativo Read

asset

time-series

GetAssetPropertyValue Concede permissão para recuperar o valor mais recente de uma propriedade de ativo Read

asset

time-series

GetAssetPropertyValueHistory Concede permissão para recuperar o histórico de valor de uma propriedade de ativo Read

asset

time-series

GetInterpolatedAssetPropertyValues Concede permissão para recuperar valores interpolados de uma propriedade de ativo Read

asset

time-series

ListAccessPolicies Concede permissão para listar todas as políticas de acesso para uma identidade ou um recurso List

portal

project

ListAssetModels Concede permissão para listar todos os modelos de ativos List
ListAssetRelationships Concede permissão para listar o gráfico de relacionamento de ativo para um ativo List

asset*

ListAssets Concede permissão para listar todos os ativos List

asset-model

ListAssociatedAssets Concede permissão para listar todos os ativos associados a um ativo por uma hierarquia List

asset*

ListBulkImportJobs Concede permissão para listar trabalhos de importação em massa List
ListDashboards Concede permissão para listar todos os painéis em um projeto List

project*

ListGateways Concede permissão para listar todos os gateways List
ListPortals Concede permissão para listar todos os portais List
ListProjectAssets Concede permissão para listar todos os ativos associados a um projeto List

project*

ListProjects Concede permissão para listar todos os projetos em um portal List

portal*

ListTagsForResource Concede permissão para listar todas as etiquetas de um recurso Read

access-policy

asset

asset-model

dashboard

gateway

portal

project

aws:ResourceTag/${TagKey}

ListTimeSeries Concede permissão para listar séries temporais List

asset

PutDefaultEncryptionConfiguration Concede permissão para definir a configuração padrão de criptografia da Conta da AWS Write
PutLoggingOptions Concede permissão para definir as opções de log da Conta da AWS Write
PutStorageConfiguration Concede permissão para definir as configurações de armazenamento para a Conta da AWS Write
TagResource Concede permissão para marcar um recurso Marcação

access-policy

asset

asset-model

dashboard

gateway

portal

project

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource Concede permissão para desmarcar um recurso Marcação

access-policy

asset

asset-model

dashboard

gateway

portal

project

aws:TagKeys

UpdateAccessPolicy Concede permissão para atualizar uma política de acesso Write

access-policy*

UpdateAsset Concede permissão para atualizar um ativo Write

asset*

UpdateAssetModel Concede permissão para atualizar um modelo de ativo Write

asset-model*

UpdateAssetModelPropertyRouting [somente permissão] Concede permissão para atualizar um roteamento de propriedade AssetModel Write

asset-model*

UpdateAssetProperty Concede permissão para atualizar uma propriedade de ativo Write

asset*

UpdateDashboard Concede permissão para atualizar um painel Write

dashboard*

UpdateGateway Concede permissão para atualizar um gateway Write

gateway*

UpdateGatewayCapabilityConfiguration Concede permissão para atualizar uma configuração de capacidade para um gateway Write

gateway*

UpdatePortal Concede permissão para atualizar um portal Write

portal*

UpdateProject Concede permissão para atualizar um projeto Write

project*

Tipos de recursos definidos pelo AWS IoT SiteWise

Os seguintes tipos de recursos são definidos por este serviço e podem ser usados no elemento Resource de declarações de políticas de permissão do IAM. 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. Para obter detalhes sobre as colunas na tabela a seguir, consulte Tabela de tipos de recursos.

Tipos de recursos ARN Chaves de condição
asset arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

aws:ResourceTag/${TagKey}

asset-model arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

aws:ResourceTag/${TagKey}

time-series arn:${Partition}:iotsitewise:${Region}:${Account}:time-series/${TimeSeriesId}
gateway arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}

aws:ResourceTag/${TagKey}

portal arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}

aws:ResourceTag/${TagKey}

project arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}

aws:ResourceTag/${TagKey}

dashboard arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}

aws:ResourceTag/${TagKey}

access-policy arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}

aws:ResourceTag/${TagKey}

Chaves de condição do AWS IoT SiteWise

O AWS IoT SiteWise define as seguintes chaves de condição que podem ser usadas no elemento Condition de uma política do IAM. É 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 visualizar as chaves de condição globais 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 o acesso pelos pares de chave-valor da etiqueta na solicitação String
aws:ResourceTag/${TagKey} Filtra o acesso pelas etiquetas anexadas ao recurso String
aws:TagKeys Filtra o acesso pelas chaves da etiqueta na solicitação ArrayOfString
iotsitewise:assetHierarchyPath Filtra o acesso por um caminho de hierarquia de ativos, que é a string de IDs de ativos na hierarquia do ativo, cada um separado por uma barra String
iotsitewise:childAssetId Filtra o acesso pelo ID de um ativo filho que está sendo associado a um ativo pai String
iotsitewise:group Filtra o acesso pelo ID de um grupo do AWS Single Sign-On String
iotsitewise:iam Filtra o acesso pelo ID de uma identidade do AWS IAM String
iotsitewise:isAssociatedWithAssetProperty Filtra o acesso por Data Streams (fluxos de dados) associados ou não às propriedades do ativo String
iotsitewise:portal Filtra o acesso pelo ID de um portal String
iotsitewise:project Filtra o acesso pelo ID de um projeto String
iotsitewise:propertyAlias Filtra o acesso pelo alias da propriedade String
iotsitewise:propertyId Filtra o acesso pelo ID de uma propriedade de ativo String
iotsitewise:user Filtra o acesso pelo ID de um usuário do AWS Single Sign-On String