Todos os produtos
Search
Central de documentação

Object Storage Service:create-access-point

Última atualização: Sep 24, 2026

O comando create-access-point configura pontos de acesso para um bucket.

Observações

  • Uma conta Alibaba Cloud tem autorização automática para criar pontos de acesso. Para criá-los por meio de um usuário RAM ou do Security Token Service (STS), você deve ter a permissão oss:CreateAccessPoint. Para instruções detalhadas, consulte conceder política personalizada a um usuário RAM.

  • É possível criar até 1.000 pontos de acesso em uma única conta Alibaba Cloud.

  • É possível configurar até 100 pontos de acesso por bucket.

Sintaxe

ossutil api create-access-point --bucket value --create-access-point-configuration value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket.

--create-access-point-configuration

string

O contêiner que armazena as informações do ponto de acesso.

Nota

O comando create-access-point corresponde à operação de API CreateAccessPoint. Para mais informações sobre os parâmetros dessa operação, consulte CreateAccessPoint.

--create-access-point-configuration

A opção --create-access-point-configuration aceita os formatos XML e JSON. Se o valor da opção contiver o prefixo 'file://', o comando lê os parâmetros de configuração do arquivo especificado.

  • Formato XML:

    <CreateAccessPointConfiguration>
      <VpcConfiguration>
        <VpcId>string</VpcId>
      </VpcConfiguration>
      <AccessPointName>string</AccessPointName>
      <NetworkOrigin>string</NetworkOrigin>
    </CreateAccessPointConfiguration>
  • Formato JSON:

    {
      "AccessPointName": "string",
      "NetworkOrigin": "string",
      "VpcConfiguration": {
        "VpcId": "string"
      }
    }
Nota

Para detalhes sobre as opções de linha de comando globais compatíveis, consulte Opções de linha de comando.

Exemplo

O código a seguir mostra um exemplo de configuração de um ponto de acesso chamado 'ap-01' associado ao examplebucket:

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

    <?xml version="1.0" encoding="UTF-8"?>
    <CreateAccessPointConfiguration>
        <AccessPointName>ap-01</AccessPointName>
        <NetworkOrigin>internet</NetworkOrigin>
    </CreateAccessPointConfiguration>

    Comando de exemplo:

    ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-point-configuration.xml
  • Crie um arquivo de configuração chamado create-access-point-configuration.json e adicione o seguinte código:

    {
      "AccessPointName": "ap-01",
      "NetworkOrigin": "internet"
    }

    Comando de exemplo:

    ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-monitor-configuration.json
  • Configure os parâmetros no formato JSON no comando a seguir:

    ossutil api create-access-point --bucket examplebucket --create-access-point-configuration  "{\"AccessPointName\":\"ap-01\",\"NetworkOrigin\":\"internet\"}"