Todos os produtos
Search
Central de documentação

Object Storage Service:put-access-point-policy

Última atualização: Sep 24, 2026

O comando put-access-point-policy cria políticas de ponto de acesso.

Notas de uso

Por padrão, uma conta Alibaba Cloud possui as permissões necessárias para criar políticas de ponto de acesso. Para criar políticas de ponto de acesso como usuário RAM ou por meio do Security Token Service (STS), você precisa da permissão oss:PutAccessPointPolicy. Para obter mais informações, consulte Grant custom permission policies to RAM users.

Sintaxe

ossutil api put-access-point-policy --bucket value --access-point-name value --body value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--access-point-name

string

Nome do ponto de acesso.

--body

string

Configurações da política do ponto de acesso.

Nota

O comando put-access-point-policy corresponde à operação PutAccessPointPolicy. Para obter mais informações sobre os parâmetros envolvidos, consulte PutAccessPointPolicy.

--body

A opção de configuração --body aceita o formato JSON. Se o valor da opção contiver o prefixo 'file://', os parâmetros de configuração serão lidos do arquivo especificado.

Formato JSON:

{
  "Version": "1",
  "Statement": [
    {
      "Action": [
        "oss:PutObject",
        "oss:GetObject"
      ],
      "Effect": "Deny",
      "Principal": [
        "string"
      ],
      "Resource": [
        "string"
      ]
    }
  ]
}
  • Version: versão da política. Valor padrão: 1.

  • Statement: uma política contém um ou mais arrays de declarações, cada um definindo um conjunto de permissões.

    • Action: lista de operações permitidas ou negadas, como oss:PutObject e oss:GetObject.

    • Effect: indica se a declaração permite ou nega o acesso. Valores possíveis: Allow ou Deny.

    • Principal: entidade à qual a política se aplica.

    • Resource: escopo de recursos aos quais a política se aplica.

Nota

Para obter mais informações, consulte Supported global command line options.

Exemplos

Associe uma política de ponto de acesso ao ponto de acesso chamado ap-01, vinculado ao bucket examplebucket.

  • Crie um arquivo de configuração chamado access-point-name.json e adicione o seguinte código:

    {
      "Version": "1",
      "Statement": [
        {
          "Action": [
            "oss:PutObject",
            "oss:GetObject"
          ],
          "Effect": "Deny",
          "Principal": [
            "27737962156157xxxx"
          ],
          "Resource": [
            "acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01",
            "acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01/object/*"
          ]
        }
      ]
    }

    Comando de exemplo:

    ossutil api put-access-point-policy --bucket examplebucket --access-point-name ap-01 --body file://access-point-name.json
  • Configure os parâmetros diretamente no comando a seguir, no formato JSON:

    ossutil api put-access-point-policy --bucket examplebucket --access-point-name ap-01 --body "{\"Version\":\"1\",\"Statement\":[{\"Action\":[\"oss:PutObject\",\"oss:GetObject\"],\"Effect\":\"Deny\",\"Principal\":[\"27737962156157xxxx\"],\"Resource\":[\"acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/$ap-01\",\"acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01/object/*\"]}]}"