Sas - Get Token

Servicio:

Planetary Computer

Versión de la API:

2025-04-30-preview

genere un token de SAS para la cuenta y el contenedor de Azure Blob Storage especificados.
Genere un token de SAS para la cuenta de almacenamiento y el contenedor especificados. La cuenta de almacenamiento y el contenedor deben estar asociados a un conjunto de datos de Planetary Computer indexado por la API de STAC.

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/sas/token/{collectionId}?api-version=2025-04-30-preview

Con parámetros opcionales:

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/sas/token/{collectionId}?api-version=2025-04-30-preview&duration={duration}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
collectionId	path	True	string	Nombre de la colección para la que se emitirá el token de SAS.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.
duration	query		integer (int64)	La duración, en minutos, que el token de SAS será válido. Solo válido para usuarios homologados.

Respuestas

Nombre	Tipo	Description
200 OK	SasToken	Respuesta exitosa
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Seguridad

OAuth2Auth

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
https://geocatalog.spatio.azure.com/.default

Ejemplos

Sas_GetToken

Solicitud de ejemplo

HTTP

GET https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/sas/token/weather-sample?api-version=2025-04-30-preview

Respuesta de muestra

status code:

200

{
  "msft:expiry": "2025-03-12T20:47:34Z",
  "token": "sastoken"
}

Definiciones

Nombre	Description
Azure.Core.Foundations.Error	Objeto de error.
Azure.Core.Foundations.ErrorResponse	Respuesta que contiene los detalles del error.
Azure.Core.Foundations.InnerError	Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
SasToken	SasToken

Azure.Core.Foundations.Error

Object

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	Azure.Core.Foundations.Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	Azure.Core.Foundations.InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Una representación en lenguaje natural del error.
target	string	Destino del error.

Azure.Core.Foundations.ErrorResponse

Object

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	Azure.Core.Foundations.Error	Objeto de error.

Azure.Core.Foundations.InnerError

Object

Objeto que contiene información más específica sobre el error. Según las directrices de la API de Microsoft One: https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
innererror	Azure.Core.Foundations.InnerError	Error interno.

SasToken

Object

SasToken

Nombre	Tipo	Description
msft:expiry	string (date-time)	msft:Caducidad La fecha y hora de expiración del token de SAS en UTC.
token	string	Seña Cadena de token de SAS utilizada para la autenticación.