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á.
Ações, recursos e chaves de condição para AWS IoT SiteWise
AWS A IoT SiteWise (prefixo do 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. 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.
Tópicos
Ações definidas pela AWS IoT SiteWise
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 |
---|---|---|---|---|---|
AssociateAssets | Concede permissão para associar um ativo filho a um ativo pai por uma hierarquia | Escrever | |||
AssociateTimeSeriesToAssetProperty | Concede permissão para associar uma série temporal a uma propriedade de ativo | Escrever | |||
BatchAssociateProjectAssets | Concede permissão para associar ativos a um projeto | Write | |||
BatchDisassociateProjectAssets | Concede permissão para desassociar ativos de um projeto | Escrever | |||
BatchGetAssetPropertyAggregates | Concede permissão para recuperar agregados computados para várias propriedades do ativo | Leitura | |||
BatchGetAssetPropertyValue | Concede permissão para recuperar o valor mais recente de várias propriedades do ativo | Leitura | |||
BatchGetAssetPropertyValueHistory | Concede permissão para recuperar o histórico do valor de várias propriedades do ativo | Leitura | |||
BatchPutAssetPropertyValue | Concede permissão para colocar valores de propriedade para propriedades de ativos | Write | |||
CreateAccessPolicy | Concede permissão para criar uma política de acesso para um portal ou um projeto | Write | |||
CreateAsset | Concede permissão para criar um ativo usando um modelo de ativo | Write | |||
CreateAssetModel | Concede permissão para criar um modelo de ativo | Escrever | |||
CreateAssetModelCompositeModel | Concede permissão para criar um modelo composto de modelo de ativo dentro de um modelo de ativo | Escrever | |||
CreateBulkImportJob | Concede permissão para criar um trabalho de importação em massa | Escrever | |||
CreateDashboard | Concede permissão para criar um painel em um projeto | Escrever | |||
CreateDataset | Concede permissão para criar um conjunto de dados | Escrever | |||
CreateGateway | Concede permissão para criar um gateway | Write | |||
CreatePortal | Concede permissão para criar um portal | Write |
sso:CreateManagedApplicationInstance sso:DescribeRegisteredRegions |
||
CreateProject | Concede permissão para criar um projeto em um portal | Write | |||
DeleteAccessPolicy | Concede permissão para excluir uma política de acesso | Write | |||
DeleteAsset | Concede permissão para excluir um ativo | Write | |||
DeleteAssetModel | Concede permissão para excluir um modelo de ativo | Escrever | |||
DeleteAssetModelCompositeModel | Concede permissão para excluir um modelo composto de modelo de ativo | Escrever | |||
DeleteDashboard | Concede permissão para excluir um painel | Escrever | |||
DeleteDataset | Concede permissão para excluir um conjunto de dados | Escrever | |||
DeleteGateway | Concede permissão para excluir um gateway | Write | |||
DeletePortal | Concede permissão para excluir um portal | Write |
sso:DeleteManagedApplicationInstance |
||
DeleteProject | Concede permissão para excluir um projeto | Escrever | |||
DeleteTimeSeries | Concede permissão para excluir uma série temporal | Escrever | |||
DescribeAccessPolicy | Concede permissão para descrever uma política de acesso | Leitura | |||
DescribeAction | Concede permissão para descrever ações | Leitura | |||
DescribeAsset | Concede permissão para descrever um ativo | Leitura | |||
DescribeAssetCompositeModel | Concede permissão para descrever um modelo composto de ativo | Leitura | |||
DescribeAssetModel | Concede permissão para descrever um modelo de ativo | Leitura | |||
DescribeAssetModelCompositeModel | Concede permissão para descrever um modelo composto de modelo de ativos | Leitura | |||
DescribeAssetProperty | Concede permissão para descrever uma propriedade de ativo | Leitura | |||
DescribeBulkImportJob | Concede permissão para descrever um trabalho de importação em massa | Leitura | |||
DescribeDashboard | Concede permissão para descrever um painel | Leitura | |||
DescribeDataset | Concede permissão para descrever o conjunto de dados | Leitura | |||
DescribeDefaultEncryptionConfiguration | Concede permissão para descrever a configuração de criptografia padrão para o Conta da AWS | Leitura | |||
DescribeGateway | Concede permissão para descrever um gateway | Read | |||
DescribeGatewayCapabilityConfiguration | Concede permissão para descrever uma configuração de capacidade para um gateway | Leitura | |||
DescribeLoggingOptions | Concede permissão para descrever as opções de registro para o Conta da AWS | Leitura | |||
DescribePortal | Concede permissão para descrever um portal | Read | |||
DescribeProject | Concede permissão para descrever um projeto | Leitura | |||
DescribeStorageConfiguration | Concede permissão para descrever a configuração de armazenamento do Conta da AWS | Leitura | |||
DescribeTimeSeries | Concede permissão para descrever uma série temporal | Leitura | |||
DisassociateAssets | Concede permissão para desassociar um ativo filho de um ativo pai por uma hierarquia | Escrever | |||
DisassociateTimeSeriesFromAssetProperty | Concede permissão para desassociar uma série temporal de uma propriedade de ativo | Escrever | |||
EnableSiteWiseIntegration [somente permissão] | Concede permissão para permitir a SiteWise integração da IoT com outros serviços | Escrever | |||
ExecuteAction | Concede permissão para executar ações | Escrever | |||
ExecuteQuery | Concede permissão para executar uma consulta | Leitura | |||
GetAssetPropertyAggregates | Concede permissão para recuperar agregados computados para uma propriedade de ativo | Read | |||
GetAssetPropertyValue | Concede permissão para recuperar o valor mais recente de uma propriedade de ativo | Read | |||
GetAssetPropertyValueHistory | Concede permissão para recuperar o histórico de valor de uma propriedade de ativo | Leitura | |||
GetInterpolatedAssetPropertyValues | Concede permissão para recuperar valores interpolados de uma propriedade de ativo | Leitura | |||
InvokeAssistant | Concede permissão para invocar um assistente | Leitura | |||
ListAccessPolicies | Concede permissão para listar todas as políticas de acesso para uma identidade ou um recurso | Listar | |||
ListActions | Concede permissão para listar todas as ações | Listar | |||
ListAssetModelCompositeModels | Concede permissão para listar todos os modelos compostos de modelos de ativos | Listar | |||
ListAssetModelProperties | Concede permissão para listar propriedades dos modelos de ativos | Listar | |||
ListAssetModels | Concede permissão para listar todos os modelos de ativos | Listar | |||
ListAssetProperties | Concede permissão para listar propriedades de ativos | Listar | |||
ListAssetRelationships | Concede permissão para listar o gráfico de relacionamento de ativo para um ativo | List | |||
ListAssets | Concede permissão para listar todos os ativos | Listar | |||
ListAssociatedAssets | Concede permissão para listar todos os ativos associados a um ativo por uma hierarquia | Listar | |||
ListBulkImportJobs | Concede permissão para listar trabalhos de importação em massa | Listar | |||
ListCompositionRelationships | Concede permissão para listar todas as relações de composição de modelos de ativos | Listar | |||
ListDashboards | Concede permissão para listar todos os painéis em um projeto | Listar | |||
ListDatasets | Concede permissão para listar todos os conjuntos de dados | Listar | |||
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 | |||
ListProjects | Concede permissão para listar todos os projetos em um portal | List | |||
ListTagsForResource | Concede permissão para listar todas as etiquetas de um recurso | Leitura | |||
ListTimeSeries | Concede permissão para listar séries temporais | Listar | |||
PutDefaultEncryptionConfiguration | Concede permissão para definir a configuração de criptografia padrão para o Conta da AWS | Escrever | |||
PutLoggingOptions | Concede permissão para definir opções de registro para o Conta da AWS | Escrever | |||
PutStorageConfiguration | Concede permissão para definir as configurações de armazenamento para o Conta da AWS | Escrever | |||
TagResource | Concede permissão para marcar um recurso | Marcação | |||
UntagResource | Concede permissão para desmarcar um recurso | Marcação | |||
UpdateAccessPolicy | Concede permissão para atualizar uma política de acesso | Write | |||
UpdateAsset | Concede permissão para atualizar um ativo | Write | |||
UpdateAssetModel | Concede permissão para atualizar um modelo de ativo | Escrever | |||
UpdateAssetModelCompositeModel | Concede permissão para atualizar um modelo composto de modelo de ativo | Escrever | |||
UpdateAssetModelPropertyRouting [somente permissão] | Concede permissão para atualizar o roteamento de uma AssetModel propriedade | Escrever | |||
UpdateAssetProperty | Concede permissão para atualizar uma propriedade de ativo | Write | |||
UpdateDashboard | Concede permissão para atualizar um painel | Escrever | |||
UpdateDataset | Concede permissão para atualizar um conjunto de dados | Escrever | |||
UpdateGateway | Concede permissão para atualizar um gateway | Write | |||
UpdateGatewayCapabilityConfiguration | Concede permissão para atualizar uma configuração de capacidade para um gateway | Write | |||
UpdatePortal | Concede permissão para atualizar um portal | Write | |||
UpdateProject | Concede permissão para atualizar um projeto | Escrever |
Tipos de recursos definidos pela AWS IoT SiteWise
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 |
---|---|---|
asset |
arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}
|
|
asset-model |
arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}
|
|
time-series |
arn:${Partition}:iotsitewise:${Region}:${Account}:time-series/${TimeSeriesId}
|
|
gateway |
arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}
|
|
portal |
arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}
|
|
project |
arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}
|
|
dashboard |
arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}
|
|
access-policy |
arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}
|
|
dataset |
arn:${Partition}:iotsitewise:${Region}:${Account}:dataset/${DatasetId}
|
Chaves de condição para AWS IoT SiteWise
AWS A IoT SiteWise define as seguintes chaves de condição que podem ser usadas no Condition
elemento de uma IAM 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 exibir 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 da hierarquia de ativos, que é a sequência de caracteres do ativo IDs 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 de login AWS único | String |
iotsitewise:iam | Filtra o acesso pelo ID de uma AWS IAM identidade | 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 de login AWS único | String |