Stac Collection Assets - Create

Référence

Service:: Planetary Computer

Version d'API:: 2025-04-30-preview

Création d’un actif de collection
Créez une ressource dans les métadonnées de la collection et écrivez le fichier associé dans le stockage géré.

Args : request : La demande entrante. asset : objet Asset à écrire, sans href valide pour l’asset. file : fichier à écrire. collection_id : ID de la collection dans laquelle écrire la ressource. content_type : le type de contenu de la demande.

Renvoie : objet Response contenant la ressource nouvellement créée.

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/collections/{collectionId}/assets?api-version=2025-04-30-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
data	formData	True	string	Métadonnées des ressources
file	formData	True	file	Contenu du fichier binaire à télécharger.
collectionId	path	True	string maxLength: 500 pattern: .*	STAC Collection ID
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	StacCollection	La demande a réussi.
201 Created	StacCollection	La requête a réussi et une nouvelle ressource a été créée en conséquence.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Nom

Type

Description

200 OK

StacCollection

La demande a réussi.

201 Created

StacCollection

La requête a réussi et une nouvelle ressource a été créée en conséquence.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

StacCollectionAssets_Create

Exemple de requête

HTTP

POST https://contoso-catalog.gwhqfdeddydpareu.uksouth.geocatalog.spatio.azure.com/stac/collections/test-collection-d45537668d06/assets?api-version=2025-04-30-preview

Exemple de réponse

Code d’état:: 201

{
  "type": "Collection",
  "id": "test-collection-b07e7de4387b",
  "stac_version": "1.0.0",
  "description": "A collection for integration tests purposes",
  "links": [
    {
      "rel": "items",
      "type": "application/geo+json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/test-collection-b07e7de4387b/items"
    },
    {
      "rel": "parent",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
    },
    {
      "rel": "root",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
    },
    {
      "rel": "self",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/test-collection-b07e7de4387b"
    }
  ],
  "msft:_created": "2024-11-06T22:41:26.982611Z",
  "msft:_updated": "2024-11-06T22:41:27.735413Z",
  "title": "Test Collection b07e7de4387b",
  "extent": {
    "spatial": {
      "bbox": [
        [
          -180,
          -90,
          180,
          90
        ]
      ]
    },
    "temporal": {
      "interval": [
        [
          "2020-01-01T00:00:00Z",
          null
        ]
      ]
    }
  },
  "license": "CC-BY-4.0",
  "assets": {
    "visual": {
      "href": "https://ysuxzldatasa.blob.core.windows.net/test-collection-b07e7de4387b-61cc3d6e/collection-assets/visual/text.txt",
      "type": "image/png",
      "title": "visual",
      "description": "This is an example upload",
      "roles": [
        "visual",
        "transaction"
      ]
    }
  }
}

Code d’état:: 200

{
  "type": "Collection",
  "id": "test-collection-b07e7de4387b",
  "stac_version": "1.0.0",
  "description": "A collection for integration tests purposes",
  "links": [
    {
      "rel": "items",
      "type": "application/geo+json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/test-collection-b07e7de4387b/items"
    },
    {
      "rel": "parent",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
    },
    {
      "rel": "root",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/"
    },
    {
      "rel": "self",
      "type": "application/json",
      "href": "https://sample.cmbtazhseqhgeudd.uksouth.geocatalog.spatio.azure.com/stac/collections/test-collection-b07e7de4387b"
    }
  ],
  "msft:_created": "2024-11-06T22:41:26.982611Z",
  "msft:_updated": "2024-11-06T22:41:27.735413Z",
  "title": "Test Collection b07e7de4387b",
  "extent": {
    "spatial": {
      "bbox": [
        [
          -180,
          -90,
          180,
          90
        ]
      ]
    },
    "temporal": {
      "interval": [
        [
          "2020-01-01T00:00:00Z",
          null
        ]
      ]
    }
  },
  "license": "CC-BY-4.0",
  "assets": {
    "visual": {
      "href": "https://ysuxzldatasa.blob.core.windows.net/test-collection-b07e7de4387b-61cc3d6e/collection-assets/visual/text.txt",
      "type": "image/png",
      "title": "visual",
      "description": "This is an example upload",
      "roles": [
        "visual",
        "transaction"
      ]
    }
  }
}

Définitions

Nom	Description
Asset	https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#asset-object Représente un actif STAC, c’est-à-dire un fichier ou une ressource associé à un élément STAC.
Azure.Core.Foundations.Error	Objet d’erreur.
Azure.Core.Foundations.ErrorResponse	Réponse contenant les détails de l’erreur.
Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
Extent	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#extent-object Représente l’étendue spatiale et temporelle d’une collection STAC.
Link	Modèle de lien. Ref : http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml Représente un lien.
LinkType	Types MIME pour les liens.
Provider	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#provider-object Représente des informations sur un fournisseur de données pour les collections et les éléments STAC.
SpatialExtent	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#spatial-extent-object Représente l’étendue spatiale d’une collection STAC avec des cadres englobants.
StacCollection	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md Représente une collection STAC.
TimeInterval	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#temporal-extent-object Représente l’étendue temporelle d’une collection STAC avec des intervalles de temps.

Asset

Object

https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/item-spec.md#asset-object

Représente un actif STAC, c’est-à-dire un fichier ou une ressource associé à un élément STAC.

Nom	Type	Description
constellation	string	Constellation de satellites qui ont acquis les données.
created	string (date-time)	Horodatage de création des données.
description	string	Description détaillée de l’actif.
gsd	number (float)	Distance de l’échantillon au sol en mètres.
href	string minLength: 1	URL du fichier de ressources.
instruments	string[]	Instruments qui ont acquis les données.
mission	string	Mission associée aux données.
platform	string	Plateforme qui a acquis les données.
providers	Provider[]	Les organisations ou les individus qui fournissent les données.
roles	string[]	Rôles de l’actif au sein de l’élément.
title	string	Titre lisible par l’homme pour la ressource.
type	string	Type de média de la ressource.
updated	string (date-time)	Horodatage de la dernière mise à jour des données.

Azure.Core.Foundations.Error

Object

Objet d’erreur.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
details	Azure.Core.Foundations.Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	Azure.Core.Foundations.InnerError	Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.
message	string	Une représentation lisible par une personne de l'erreur.
target	string	Cible de l’erreur.

Azure.Core.Foundations.ErrorResponse

Object

Réponse contenant les détails de l’erreur.

Nom	Type	Description
error	Azure.Core.Foundations.Error	Objet d’erreur.

Azure.Core.Foundations.InnerError

Object

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Nom	Type	Description
code	string	Un ensemble de codes d’erreur définis par le serveur.
innererror	Azure.Core.Foundations.InnerError	Erreur interne.

Extent

Object

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#extent-object

Représente l’étendue spatiale et temporelle d’une collection STAC.

Nom	Type	Description
spatial	SpatialExtent	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#spatial-extent-object Étendue spatiale définie par des cadres englobants.
temporal	TimeInterval	https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#temporal-extent-object Étendue temporelle définie par des intervalles de temps.

Nom

Type

Description

spatial

SpatialExtent

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#spatial-extent-object

Étendue spatiale définie par des cadres englobants.

temporal

TimeInterval

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#temporal-extent-object

Étendue temporelle définie par des intervalles de temps.

Link

Object

Modèle de lien.

Ref : http://schemas.opengis.net/ogcapi/features/part1/1.0/openapi/schemas/link.yaml

Représente un lien.

Nom	Type	Valeur par défaut	Description
body	object		Pour les requêtes POST, la ressource peut spécifier le corps HTTP en tant qu’objet JSON.
headers	object		Paires clé-valeur d’objet mappées aux en-têtes. Exemple : { « Accept » : « application/json » }.
href	string		URL du lien.
hreflang	string		Langue de la ressource liée.
length	integer (int32)		Longueur de la ressource liée.
merge	boolean	False	Indique si le client doit fusionner la valeur body dans le corps de la requête actuelle avant de suivre le lien. Cette option n’est valable que lorsque le serveur répond à une requête POST. Valeur par défaut : false.
method	enum: GET POST	GET	Spécifie la méthode HTTP attendue par la ressource. Par défaut : GET.
rel	string		Type de relation du lien.
title	string		Le titre du lien.
type	LinkType	application/json	Type MIME de la ressource liée.

LinkType

Énumération

Types MIME pour les liens.

Valeur	Description
application/geo+json	Représente une application/geo+json.
application/json	Représente une application/json.
application/x-binary	Représente une application/x-binaire.
application/x-protobuf	Représente une application/x-protobuf.
application/xml	Représente une application/xml.
image/jp2	Représente une image/jp2.
image/jpeg	Représente une image/jpeg.
image/jpg	Représente une image/jpg.
image/png	Représente une image/png.
image/tiff; application=geotiff	Représente une image/tiff avec application=geotiff.
image/webp	Représente une image/webp.
text/html	Représente un texte/html.
text/plain	Représente un texte/simple.

Provider

Object

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#provider-object

Représente des informations sur un fournisseur de données pour les collections et les éléments STAC.

Nom	Type	Description
description	string	Description du prestataire.
name	string minLength: 1	Nom de l’organisation ou de la personne du fournisseur.
roles	string[]	Rôles joués par le fournisseur (p. ex., producteur, transformateur, hôte).
url	string	URL du site Web du fournisseur.

SpatialExtent

Object

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#spatial-extent-object

Représente l’étendue spatiale d’une collection STAC avec des cadres englobants.

Nom	Type	Description
bbox	number[] (double)	Tableau de cadres englobants définissant l’étendue spatiale, au format [[ouest, sud, est, nord]].

StacCollection

Object

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md

Représente une collection STAC.

Nom	Type	Valeur par défaut	Description
assets	<string, Asset>		Actifs
description	string minLength: 1		Description détaillée de la collection.
extent	Extent		Étendue spatiale et temporelle de la collection.
id	string minLength: 1 maxLength: 500 pattern: .*		Identificateur unique de la collection.
keywords	string[]		Mots-clés décrivant la collection.
license	string minLength: 1		Identificateur de licence pour les données de collecte.
links	Link[]		Liens vers des ressources et des points de terminaison connexes.
msft:_created	string		Création de MSFT
msft:_updated	string		MSFT mis à jour
msft:short_description	string maxLength: 300		MSFT Brève description
providers	Provider[]		Les organisations ou les personnes qui fournissent les données de collecte.
stac_extensions	string[]		URL vers les extensions STAC implémentées par cette ressource STAC.
stac_version	string minLength: 1	1.0.0	Stac Version
summaries	object		https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#summaries Résumés
title	string		Titre lisible par l’homme pour la collection.
type	string minLength: 1	Collection	Catégorie

TimeInterval

Object

https://github.com/radiantearth/stac-spec/blob/v1.0.0/collection-spec/collection-spec.md#temporal-extent-object

Représente l’étendue temporelle d’une collection STAC avec des intervalles de temps.

Nom	Type	Description
interval	string[]	Tableau d’intervalles de temps au format [[start_datetime, end_datetime]].

Partager via

Stac Collection Assets - Create

Paramètres URI

Réponses

Sécurité

OAuth2Auth

Étendues

Exemples

StacCollectionAssets_Create

Exemple de requête

Exemple de réponse

Définitions

Asset

Azure.Core.Foundations.Error

Azure.Core.Foundations.ErrorResponse

Azure.Core.Foundations.InnerError

Extent

Link

LinkType

Provider

SpatialExtent

StacCollection

TimeInterval