Skapa bifogad fil

  • Artikel

Åtgärden Create Attachment skapar en bifogad fil för ett dokument.

Förfrågan

Metod URI för förfrågan Description
POST https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id}/docs/{doc-name}/attachments. {databaseaccount} är namnet på det Azure Cosmos DB-konto som skapats under din prenumeration. Värdet {db-id} är det användargenererade namnet/ID:t för databasen, inte det systemgenererade ID:t (rid). Värdet {coll-id} är namnet på samlingen som dokumentet finns i. Värdet {doc-name} är namnet på dokumentet som är associerat med den bifogade filen.

Sidhuvuden

Se Vanliga REST-begärandehuvuden för Azure Cosmos DB för rubriker som används av alla Azure Cosmos DB-begäranden.

Huvud Krävs Typ Description
Dynamiskt datafält Valfritt Sträng Namnet på den bifogade filen. Det krävs bara när råmedia skickas till Azure Cosmos DB-lagringen för bifogade filer. Mer information finns i AtomPub Protocol.

Brödtext

Egenskap Krävs Typ Description
id Valfritt Sträng Krävs inte för att ställas in när råmedia kopplas. Det är en användaruppsättningsbar egenskap. Det är det unika namnet som identifierar den bifogade filen, d.v.s. att inga två bifogade filer delar samma ID. ID:t får inte överstiga 255 tecken.
Contenttype Valfritt Sträng Krävs inte för att ställas in när råmedia kopplas. Det är en användaruppsättningsbar egenskap. Den noterar innehållstypen för den bifogade filen. När du skickar de bifogade filerna som brödtext anger Cosmos DB contentType till den typ som angetts i rubriken Innehållstyp .
Media Valfritt Sträng Krävs inte för att ställas in när råmedia kopplas. Det är URL-länken eller filsökvägen där den bifogade filen finns. 
{  
    "id": "image_id",  
    "contentType": "image/jpg",  
    "media": "www.bing.com"  
}

Svarsåtgärder

Sidhuvuden

Se Vanliga REST-svarshuvuden för Azure Cosmos DB för rubriker som returneras av alla Azure Cosmos DB-svar.

Statuskoder

I följande tabell visas vanliga statuskoder som returneras av den här åtgärden. En fullständig lista över statuskoder finns i HTTP-statuskoder.

HTTP-statuskod Beskrivning
Skapad 201 Åtgärden lyckades.
400 Felaktig begäran JSON-brödtexten är ogiltig. Kontrollera om det saknas klammerparenteser eller citattecken.
409 – Konflikt Det ID eller snigel som angetts för den nya bifogade filen har tagits av en befintlig bifogad fil.
413 Entitet för stor Dokumentstorleken i begäran överskred den tillåtna dokumentstorleken i en begäran.

Brödtext

När du skapar en bifogad fil skapas en bifogad resurs med följande svarstext:

Egenskap Beskrivning
_Bli Det är en systemgenererad egenskap. Resurs-ID :t (_rid) är en unik identifierare som också är hierarkisk per resursstacken i resursmodellen. Den används internt för placering och navigering av den bifogade resursen.
_Ts Det är en systemgenererad egenskap. Den anger resursens senast uppdaterade tidsstämpel. Värdet är en tidsstämpel.
_Själv Det är en systemgenererad egenskap. Det är den unika adresserbara URI:n för resursen.
_Etag Det är en systemgenererad egenskap som anger resursetaggen som krävs för optimistisk samtidighetskontroll. 
{  
    "id": "image_id",  
    "contentType": "image/jpg",  
    "media": "www.bing.com",  
    "_rid": "Sl8fALN4sw4CAAAAAAAAAOnTcEc=",  
    "_ts": 1449606296,  
    "_self": "dbs\/Sl8fAA==\/colls\/Sl8fALN4sw4=\/docs\/Sl8fALN4sw4CAAAAAAAAAA==\/attachments\/Sl8fALN4sw4CAAAAAAAAAOnTcEc=",  
    "_etag": "\"060091c2-0000-0000-0000-56673c980000\""  
}

Exempel

POST https://contosomarketing.documents.azure.com/dbs/volcanodb/colls/volcano1/docs/c3bb1fef-fcb1-56e3-0389-f88583c3ce0d/attachments HTTP/1.1  
x-ms-session-token: 16  
x-ms-date: Tue, 08 Dec 2015 20:24:56 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3dQ8MDtRExrtOeDL5TSaHvXhPTNyKiRrrIC3IjTSpf958%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Cookie: x-ms-session-token=16  
Content-Length: 66  
Expect: 100-continue  
Connection: Keep-Alive  
{  
    "id": "image_id",  
    "contentType": "image/jpg",  
    "media": "www.bing.com"  
}  
  

HTTP/1.1 201 Created  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
x-ms-max-media-storage-usage-mb: 2048  
x-ms-media-storage-usage-mb: 0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Sun, 29 Nov 2015 19:20:18.154 GMT  
etag: "060091c2-0000-0000-0000-56673c980000"  
x-ms-resource-quota: documentSize=10240;documentsSize=10485760;collectionSize=10485760;  
x-ms-resource-usage: documentSize=0;documentsSize=291;collectionSize=369;  
x-ms-schemaversion: 1.1  
x-ms-alt-content-path: dbs/volcanodb/colls/volcano1/docs/c3bb1fef-fcb1-56e3-0389-f88583c3ce0d  
x-ms-content-path: Sl8fALN4sw4CAAAAAAAAAA==  
x-ms-quorum-acked-lsn: 18  
x-ms-session-token: 19  
x-ms-current-write-quorum: 3  
x-ms-current-replica-set-size: 4  
x-ms-request-charge: 4.95  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: c03c09bf-a791-4dad-b2f8-fa88fa1bce04  
Set-Cookie: x-ms-session-token=19; Domain=contosomarketing.documents.azure.com; Path=/dbs/volcanodb/colls/volcano1  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 20:24:57 GMT  
Content-Length: 292  
  
{  
    "id": "image_id",  
    "contentType": "image/jpg",  
    "media": "www.bing.com",  
    "_rid": "Sl8fALN4sw4CAAAAAAAAAOnTcEc=",  
    "_ts": 1449606296,  
    "_self": "dbs\/Sl8fAA==\/colls\/Sl8fALN4sw4=\/docs\/Sl8fALN4sw4CAAAAAAAAAA==\/attachments\/Sl8fALN4sw4CAAAAAAAAAOnTcEc=",  
    "_etag": "\"060091c2-0000-0000-0000-56673c980000\""  
}

Kommentarer

Det finns två sätt att skapa en resurs för bifogade filer – publicera medieinnehållet i Cosmos DB som i AtomPub-protokollet eller publicera bara metadata för bifogade filer till media som lagras externt.

Det första är att PUBLICERA råmediet i brödtextnyttolasten för att lagra det i den angivna lagringen för bifogade filer under ditt Cosmos DB-konto. Om du vill skapa den här typen av bifogad fil måste du inkludera den råa bifogade filen (video, ljud, fil, blob osv.) som brödtext i POST. Två rubriker måste anges: Innehållstyp och snigel. Rubriken Innehållstyp är inställd på MIME-typen för den bifogade filen medan slug-huvudet är inställt på namnet på den bifogade filen.

Det andra sättet att skapa en resurs för bifogade filer är att PUBLICERA egenskaperna för den bifogade filens resurs och notera typ- och medielänken för den bifogade filen. Till skillnad från den första typen av bifogad resurs får du inte ange rubrikerna Innehållstyp och Snigel.

Se även