create-access-point

Notes

• An Alibaba Cloud account is automatically authorized to create access points. To create access points through a RAM user or Security Token Service (STS), you must possess the oss:CreateAccessPoint permission. For detailed instructions, see grant custom policy to a RAM user.

• Up to 1,000 access points can be created within an Alibaba Cloud account.

• You can configure up to 100 access points for a bucket.

Syntax

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

--create-access-point-configuration

The --create-access-point-configuration option supports both XML and JSON formats. If the value of the option contains the 'file://' prefix, configuration parameters are read from the specified file.

• XML format:

  <CreateAccessPointConfiguration>
    <VpcConfiguration>
      <VpcId>string</VpcId>
    </VpcConfiguration>
    <AccessPointName>string</AccessPointName>
    <NetworkOrigin>string</NetworkOrigin>
  </CreateAccessPointConfiguration>

• JSON format:

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

Example

The following code provides an example in which an access point named 'ap-01' associated with examplebucket is configured:

• Create a configuration file named create-access-point-configuration.xml and add the following code:

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

  Sample command:

  ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-point-configuration.xml

• Create a configuration file named create-access-point-configuration.json and add the following code:

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

  Sample command:

  ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-monitor-configuration.json

• Configure parameters in the following command in the JSON format:

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