All Products
Search
Document Center

Object Storage Service:GetAccessPointForObjectProcess

Last Updated:Apr 11, 2024

Queries basic information about an Object FC Access Point.

Usage notes

By default, an Alibaba Cloud account has the permissions to query basic information about an Object FC Access Point. To query basic information about an Object FC Access Point by using a RAM user or the access credentials provided by Security Token Service (STS), you must have the oss:GetAccessPointForObjectProcess permission.

Request syntax

GET /?accessPointForObjectProcess HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-qingdao.aliyuncs.com
x-oss-access-point-for-object-process-name: fc-ap-01
Authorization: SignatureValue

Request headers

Header

Type

Required

Example

Description

x-oss-access-point-for-object-process-name

String

Yes

fc-ap-01

The name of the Object FC Access Point.

For more information about other common request headers included in a GetAccessPointForObjectProcess request, such as Host and Date, see Common request headers.

Response headers

The response to a GetAccessPointForObjectProcess request contains only common response headers. For more information, see Common response headers.

Response elements

Element

Type

Example

Description

GetAccessPointForObjectProcessResult

Container

N/A

The container that stores information about the Object FC Access Point.

Parent nodes: none

Child nodes: AccessPointNameForObjectProcess, AccessPointForObjectProcessAlias, AccessPointName, AccountId, AccessPointForObjectProcessArn, CreationDate, Status, and Endpoints

AccessPointNameForObjectProcess

String

fc-ap-01

The name of the Object FC Access Point.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: none

AccessPointForObjectProcessAlias

String

fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias

The alias of the Object FC Access Point.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: none

AccessPointName

String

ap-01

The name of the access point.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: none

AccountId

String

111933544165****

The UID of the Alibaba Cloud account to which the Object FC Access Point belongs.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: none

AccessPointForObjectProcessArn

String

acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01

The ARN of the Object FC Access Point.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: none

CreationDate

String

1626769503

The time when the Object FC Access Point was created. The value is a timestamp.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: none

Status

enable

The status of the Object FC Access Point. Valid values:

  • enable: The Object FC Access Point is created.

  • disable: The Object FC Access Point is disabled.

  • creating: The Object FC Access Point is being created.

  • deleting: The Object FC Access Point is deleted.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: none

Endpoints

Container

N/A

The container that stores the endpoints of the Object FC Access Point.

Parent nodes: GetAccessPointForObjectProcessResult

Child nodes: PublicEndpoint and InternalEndpoint

PublicEndpoint

String

fc-ap-01-111933544165****.oss-cn-qingdao.oss-object-process.aliyuncs.com

The public endpoint of the Object FC Access Point.

Parent nodes: Endpoints

Child nodes: none

InternalEndpoint

String

fc-ap-01-111933544165****.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com

The internal endpoint of the Object FC Access Point.

Parent nodes: Endpoints

Child nodes: none

PublicAccessBlockConfiguration

Container

N/A

The container in which the Block Public Access configurations are stored.

Parent nodes: GetAccessPointResult

Child nodes: BlockPublicAccess

BlockPublicAccess

Boolean

true

Indicates whether Block Public Access is enabled for the Object FC Access Point.

  • true: Block Public Access is enabled.

  • false: Block Public Access is disabled.

Parent nodes: PublicAccessBlockConfiguration

Child nodes: none

Examples

  • Sample request

    GET /?accessPointForObjectProcess HTTP/1.1
    Date: Mon, 30 Oct 2023 03:15:40 GMT
    Content-Length: 870
    Content-Type: application/xml
    Host: oss-example.oss-cn-qingdao.aliyuncs.com
    x-oss-access-point-for-object-process-name: fc-ap-01
    Authorization: OSS qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3****
  • Sample response

    HTTP/1.1 200
    <?xml version="1.0" encoding="UTF-8"?>
    <GetAccessPointForObjectProcessResult>
      <AccessPointNameForObjectProcess>fc-ap-01</AccessPointNameForObjectProcess>
      <AccessPointForObjectProcessAlias>fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias</AccessPointForObjectProcessAlias>
      <AccessPointName>ap-01</AccessPointName>
      <AccountId>111933544165****</AccountId>
      <AccessPointForObjectProcessArn>acs:oss:cn-qingdao:11933544165****:accesspointforobjectprocess/fc-ap-01</AccessPointForObjectProcessArn>
      <CreationDate>1626769503</CreationDate>
      <Status>enable</Status>
      <Endpoints>
        <PublicEndpoint>fc-ap-01-111933544165****.oss-cn-qingdao.oss-object-process.aliyuncs.com</PublicEndpoint>
        <InternalEndpoint>fc-ap-01-111933544165****.oss-cn-qingdao-internal.oss-object-process.aliyuncs.com</InternalEndpoint>
      </Endpoints>
      <PublicAccessBlockConfiguration>
        <BlockPublicAccess>true</BlockPublicAccess>
      </PublicAccessBlockConfiguration>
    </GetAccessPointForObjectProcessResult>