내보내기(0) 인쇄
모두 확장

스케줄러 REST API 참조

업데이트 날짜: 2015년 1월

이 항목에서는 Azure Scheduler에서 스케줄러 관리 REST API를 사용하여 일반적인 태스크를 수행하는 방법을 설명합니다.

  • 유효한 Azure 계정 및 활성 Azure 구독이 필요합니다. 이 설명서에서는 활성 구독과 관련 구독 ID를 이미 가지고 있다고 가정합니다.

  • Azure 구독의 관리 인증서입니다. 관리 인증서는 구독에서 리소스에 대한 클라이언트 액세스를 인증하는 데 필요합니다. 공개 키를 포함하고 파일 이름 확장명이 .cer인 X-509 v3 인증서를 사용해야 합니다. 관리 인증서를 만드는 방법에 대한 자세한 내용은 Azure에서 인증서 관리를 참조하십시오.

스케줄러 API는 Azure Scheduler 서비스와 상호 작용하여 예정된 작업 및 작업 컬렉션을 관리하는 작업의 RESTful 집합을 제공합니다.

스케줄러 관리 API는 다음과 같은 핵심 사이트 관리 시나리오 집합을 가능하게 합니다.

  1. 프로그래밍 방식으로 "작업 컬렉션"을 만들고 업데이트 및 삭제

  2. 프로그래밍 방식으로 예정된 작업을 만들고 업데이트 및 삭제

  3. 프로그래밍 방식으로 작업 컬렉션 및 작업 목록 보기

  4. 프로그래밍 방식으로 작업 상태 및 기록 보기

Azure Scheduler REST API는 작업 및 작업 컬렉션을 관리하기 위해 다음과 ���은 리소스 계층 구조를 노출합니다.

/cloudservices

   /jobcollections

      /jobs

         /history

서비스에서 요청 처리를 완료했는지 여부를 판단하려면 특히 후속 호출에서 해당 리소스를 사용해야 하거나 수정 또는 삭제가 실제로 발생하는지 확인해야 하는 경우 작업 상태 가져오기를 호출합니다. 비동기 작업에 대한 자세한 내용은 비동기 서비스 관리 요청 추적을 참조하십시오.

새 리소스는 HTTP POST 또는 PUT 동사로 만들어집니다. 리소스가 만들어지면 HTTP 200(정상), 201(생성됨) 또는 202 수락됨) 상태 코드가 반환되고 직렬화된 리소스 개체가 응답 본문에 포함됩니다. 클라이언트가 이미 있는 리소스를 만들려고 하면 HTTP 400(잘못된 요청) 또는 409(충돌) 상태 코드가 반환됩니다.

기존 리소스의 현재 상태를 읽으려면 HTTP GET 동사가 사용됩니다. 리소스가 있으면 응답 상태 코드는 200 또는 202이고, 응답 본문은 직렬화된 개체를 포함하게 됩니다. 리소스가 없는 경우 응답 상태 코드가 400(잘못된 요청) 또는 202(찾을 수 없음)입니다.

기존 리소스는 HTTP PUT 또는 PATCH 동사로 업데이트됩니다. 개체 이름이 URL 문자열에 전달되고 개체의 새로운 상태가 요청 본문에 전달됩니다. 리소스가 업데이트되면 HTTP 200 또는 202 상태 코드가 반환됩니다. 업데이트할 리소스가 없는 경우 HTTP 400(잘못된 요청) 또는 404(찾을 수 없음) 상태 코드가 반환됩니다.

기존 리소스는 HTTP DELETE 동사로 삭제됩니다. 개체 이름이 URL 문자열에 전달됩니다. 리소스가 삭제되면 HTTP 200 또는 202 상태 코드가 반환됩니다. 개체가 이미 삭제되었거나 존재하지 않는 경우 HTTP 400 또는 404가 반환됩니다.

Azure Scheduler API를 성공적으로 호출하려면 구독에 연결할 관리 인증서가 필요합니다. 자세한 내용은 서비스 관리 요청 인증을 참조하십시오. 스케줄러 서비스 끝점은 정보 공개 위험을 최소화할 수 있도록 https를 통해서만 노출됩니다.

참고 항목

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2015 Microsoft