Todos los productos
Search

Este producto

    Object Storage Service:GetAccessPoint

    Centro de documentos

    Object Storage Service:GetAccessPoint

    Última actualización: Sep 03, 2026

    Consulta la configuración y el estado de un access point específico.

    Notas de uso

    De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos para consultar información de access points. Para usar un usuario RAM o Security Token Service (STS), debe contar con el permiso oss:GetAccessPoint.

    Sintaxis de la solicitud

    GET /?accessPoint HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: ContentType
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: apname
Authorization: SignatureValue

    Encabezados de la solicitud

    Encabezado

    Tipo

    Obligatorio

    Ejemplo

    Descripción

    x-oss-access-point-name

    String

    Sí

    ap-01

    Nombre del access point.

    Esta solicitud también incluye encabezados comunes como Date y Authorization. Para obtener más información, consulte Common request headers.

    Encabezados de la respuesta

    La respuesta contiene únicamente encabezados comunes. Para obtener más información, consulte Common response headers.

    Elementos de la respuesta

    Elemento

    Tipo

    Ejemplo

    Descripción

    GetAccessPointResult

    Container

    N/A

    Contenedor de la información del access point.

    Nodos padre: none

    Nodos hijo: AccessPointName, Bucket, AccountId, NetworkOrigin, VpcConfiguration, AccessPointArn, CreationDate, Alias, Status y Endpoints

    AccessPointName

    String

    ap-01

    Nombre del access point.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    Bucket

    String

    oss-example

    Nombre del bucket asociado al access point.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    AccountId

    String

    111933544165xxxx

    ID de la cuenta de Alibaba Cloud propietaria del access point.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    NetworkOrigin

    String

    vpc

    Origen de red del access point. Valores válidos:

    • vpc: Permite acceder al access point mediante un ID de virtual private cloud (VPC) específico.

    • internet: Permite acceder al access point mediante endpoints públicos e internos.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    VpcConfiguration

    Container

    N/A

    Contenedor de la información de la VPC.

    Nodos padre: GetAccessPointResult

    Nodos hijo: VpcId

    VpcId

    String

    vpc-t4nlw426y44rd3iq4xxxx

    ID de la VPC.

    Nodos padre: VpcConfiguration

    Nodos hijo: none

    AccessPointArn

    String

    arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01

    Alibaba Cloud Resource Name (ARN) del access point.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    CreationDate

    String

    1626769503

    Fecha y hora de creación del access point en formato de marca de tiempo Unix.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    Alias

    String

    ap-01-ossalias

    Alias del access point.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    Status

    enable

    Estado del access point. Valores válidos:

    • enable: El access point está creado.

    • disable: El access point está deshabilitado.

    • creating: El access point se encuentra en proceso de creación.

    • deleting: El access point se ha eliminado.

    Nodos padre: GetAccessPointResult

    Nodos hijo: none

    Endpoints

    Container

    N/A

    Contenedor de la información de endpoints del access point.

    Nodos padre: GetAccessPointResult

    Nodos hijo: PublicEndpoint e InternalEndpoint

    PublicEndpoint

    String

    ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com

    Endpoint público del access point.

    Nodos padre: Endpoints

    Nodos hijo: none

    InternalEndpoint

    String

    ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com

    Endpoint interno del access point.

    Nodos padre: Endpoints

    Nodos hijo: none

    PublicAccessBlockConfiguration

    Container

    N/A

    Contenedor de las configuraciones de Block Public Access.

    Nodos padre: GetAccessPointResult

    Nodos hijo: BlockPublicAccess

    BlockPublicAccess

    Boolean

    true

    Indica si Block Public Access está habilitado para el access point.

    • true: Block Public Access está habilitado.

    • false: Block Public Access está deshabilitado.

    Nodos padre: PublicAccessBlockConfiguration

    Nodos hijo: none

    Ejemplos

    • Solicitud de ejemplo

      GET /?accessPoint HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 10
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: ap-01
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • Respuesta exitosa de ejemplo

      HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<GetAccessPointResult>
  <AccessPointName>ap-01</AccessPointName>
  <Bucket>oss-example</Bucket>
  <AccountId>111933544165xxxx</AccountId>
  <NetworkOrigin>vpc</NetworkOrigin>
  <VpcConfiguration>
     <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
  </VpcConfiguration>
  <AccessPointArn>arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01</AccessPointArn>
  <CreationDate>1626769503</CreationDate>
  <Alias>ap-01-ossalias</Alias>
  <Status>enable</Status>
  <Endpoints>
    <PublicEndpoint>ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com</PublicEndpoint>
    <InternalEndpoint>ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com</InternalEndpoint>
  </Endpoints>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</GetAccessPointResult>

    ossutil

    Para obtener información sobre el comando de ossutil correspondiente a la operación GetAccessPoint, consulte get-access-point.