Udostępnij za pośrednictwem


Requests - Update Requests Request Name

Zaktualizuj żądanie symbolu według nazwy żądania.

PATCH https://artifacts.dev.azure.com/{organization}/_apis/symbol/requests?requestName={requestName}&api-version=7.1

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
path True

string

Nazwa organizacji usługi Azure DevOps.

api-version
query True

string

Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.

requestName
query True

string

Nazwa żądania symbolu.

Treść żądania

Nazwa Typ Opis
createdBy

string (uuid)

Identyfikator użytkownika, który utworzył ten element. Fakultatywny.

createdDate

string (date-time)

Data utworzenia tego elementu. Fakultatywny.

description

string

Opcjonalny opis skierowany do człowieka.

domainId

IDomainId

Identyfikator domeny, w którym znajduje się to żądanie. Ta właściwość nie powinna mieć wartości null.

expirationDate

string (date-time)

Opcjonalna data wygaśnięcia żądania. Żądanie stanie się niedostępne i zostanie usunięte po dacie, niezależnie od stanu. W przypadku żądania HTTP POST, jeśli data wygaśnięcia ma wartość null/brakuje, serwer przypisze domyślne dane wygasania (30 dni, chyba że zostaną zastąpione w rejestrze na poziomie konta). W przypadku funkcji PATCH, jeśli data wygaśnięcia ma wartość null/brakuje, zachowanie polega na tym, aby nie zmieniać bieżącej daty wygaśnięcia żądania.

id

string

Identyfikator tego elementu. Fakultatywny.

isChunked

boolean

Wskazuje, czy żądanie powinno być deduplikacja fragmentów

name

string

Nazwa skierowana do człowieka dla żądania. Wymagane w usłudze POST, ignorowane w funkcji PATCH.

size

integer (int64)

Łączny rozmiar dla tego żądania.

status

RequestStatus

Stan tego żądania.

storageETag

string

Nieprzezroczystym elementem ETag używanym do synchronizacji z wersją przechowywaną na końcu serwera. Fakultatywny.

url

string

Identyfikator URI, który może służyć do pobierania tego elementu w formacie nieprzetworzonym. Fakultatywny. Należy pamiętać, że różni się to od innych identyfikatorów URI, które znajdują się w zasobie pochodnym.

Odpowiedzi

Nazwa Typ Opis
200 OK

Request

Pomyślnie zaktualizowano żądanie symbolu zgodnie z nazwą żądania.

404 Not Found

Request

Nie można odnaleźć żądania symbolu określonego przez nazwę żądania.

Other Status Codes

Request

Nie można zaktualizować żądania symboli określonego przez nazwę żądania z powodu konfliktu po stronie serwera dla exmaple, niedopasowanego elementu etag.

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Zakresy

Nazwa Opis
vso.symbols_write Przyznaje możliwość odczytywania i zapisywania symboli.

Definicje

Nazwa Opis
IDomainId
Request

Żądanie symboli.

RequestStatus

Stan tego żądania.

IDomainId

Request

Żądanie symboli.

Nazwa Typ Opis
createdBy

string (uuid)

Identyfikator użytkownika, który utworzył ten element. Fakultatywny.

createdDate

string (date-time)

Data utworzenia tego elementu. Fakultatywny.

description

string

Opcjonalny opis skierowany do człowieka.

domainId

IDomainId

Identyfikator domeny, w którym znajduje się to żądanie. Ta właściwość nie powinna mieć wartości null.

expirationDate

string (date-time)

Opcjonalna data wygaśnięcia żądania. Żądanie stanie się niedostępne i zostanie usunięte po dacie, niezależnie od stanu. W przypadku żądania HTTP POST, jeśli data wygaśnięcia ma wartość null/brakuje, serwer przypisze domyślne dane wygasania (30 dni, chyba że zostaną zastąpione w rejestrze na poziomie konta). W przypadku funkcji PATCH, jeśli data wygaśnięcia ma wartość null/brakuje, zachowanie polega na tym, aby nie zmieniać bieżącej daty wygaśnięcia żądania.

id

string

Identyfikator tego elementu. Fakultatywny.

isChunked

boolean

Wskazuje, czy żądanie powinno być deduplikacja fragmentów

name

string

Nazwa skierowana do człowieka dla żądania. Wymagane w usłudze POST, ignorowane w funkcji PATCH.

size

integer (int64)

Łączny rozmiar dla tego żądania.

status

RequestStatus

Stan tego żądania.

storageETag

string

Nieprzezroczystym elementem ETag używanym do synchronizacji z wersją przechowywaną na końcu serwera. Fakultatywny.

url

string

Identyfikator URI, który może służyć do pobierania tego elementu w formacie nieprzetworzonym. Fakultatywny. Należy pamiętać, że różni się to od innych identyfikatorów URI, które znajdują się w zasobie pochodnym.

RequestStatus

Stan tego żądania.

Wartość Opis
created

Żądanie jest tworzone i otwarte do akceptowania wpisów debugowania.

none

Stan tego żądania jest niezdefiniowany lub nieistotny w bieżącym kontekście.

sealed

Żądanie jest zapieczętowane. Nie można dodawać do niego żadnych wpisów debugowania.

unavailable

Żądanie nie jest już dostępne, prawdopodobnie usunięte.