Chilkat Online Tools

Objective-C / Microsoft Graph / Create deployment (rate-based gradual rollout)

Back to Collection Items

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

CkoHttp *http = [[CkoHttp alloc] init];
BOOL success;

// Use this online tool to generate code from sample JSON: Generate Code to Create JSON

// The following JSON is sent in the request body.

// {
//   "content": {
//     "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateReference",
//     "version": "{{FeatureUpdateVersion}}"
//   },
//   "settings": {
//     "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
//     "rollout": {
//       "devicesPerOffer": 100,
//       "durationBetweenOffers": "P7D"
//     },
//     "monitoring": {
//       "monitoringRules": [
//         {
//           "@odata.type": "#microsoft.graph.windowsUpdates.monitoringRule",
//           "signal": "rollback",
//           "threshold": 5,
//           "action": "pauseDeployment"
//         }
//       ]
//     }
//   }
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"content.\"@odata.type\"" value: @"#microsoft.graph.windowsUpdates.featureUpdateReference"];
[json UpdateString: @"content.version" value: @"{{FeatureUpdateVersion}}"];
[json UpdateString: @"settings.\"@odata.type\"" value: @"microsoft.graph.windowsUpdates.windowsDeploymentSettings"];
[json UpdateInt: @"settings.rollout.devicesPerOffer" value: [NSNumber numberWithInt: 100]];
[json UpdateString: @"settings.rollout.durationBetweenOffers" value: @"P7D"];
[json UpdateString: @"settings.monitoring.monitoringRules[0].\"@odata.type\"" value: @"#microsoft.graph.windowsUpdates.monitoringRule"];
[json UpdateString: @"settings.monitoring.monitoringRules[0].signal" value: @"rollback"];
[json UpdateInt: @"settings.monitoring.monitoringRules[0].threshold" value: [NSNumber numberWithInt: 5]];
[json UpdateString: @"settings.monitoring.monitoringRules[0].action" value: @"pauseDeployment"];

// Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = @"<access_token>";

CkoHttpResponse *resp = [http PostJson3: @"https://graph.microsoft.com/beta/admin/windows/updates/deployments" contentType: @"application/json" json: json];
if (http.LastMethodSuccess == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

NSLog(@"%d",[resp.StatusCode intValue]);
NSLog(@"%@",resp.BodyStr);

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-d '{
    "content": {
        "@odata.type": "#microsoft.graph.windowsUpdates.featureUpdateReference",
        "version": "{{FeatureUpdateVersion}}"
    },
    "settings": {
        "@odata.type": "microsoft.graph.windowsUpdates.windowsDeploymentSettings",
        "rollout": {
            "devicesPerOffer": 100,
            "durationBetweenOffers": "P7D"
        },
        "monitoring": {
            "monitoringRules": [
                {
                    "@odata.type": "#microsoft.graph.windowsUpdates.monitoringRule",
                    "signal": "rollback",
                    "threshold": 5,
                    "action": "pauseDeployment"
                }
            ]
        }
    }
}'
https://graph.microsoft.com/beta/admin/windows/updates/deployments

Postman Collection Item JSON

{
  "name": "Create deployment (rate-based gradual rollout)",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "try {",
          "    if (responseBody.indexOf(\"InvalidAuthenticationToken\") !== -1)",
          "    {",
          "        console.log(\"You need to run *On behalf of a User | Get User Access Token* request first.\");",
          "    }",
          "    else",
          "    {",
          "        if (pm.response.status === \"Forbidden\")",
          "        {",
          "            console.log(\"You need to add user delegated permissions in your application to at least *WindowsUpdates.ReadWrite.All* in portal.azure.com and then grant admin consent. Afterwards, re-run *On behalf of a User | Get User Access Token* request to update access token.\");",
          "        }",
          "    }",
          "}",
          "catch (e) {",
          "    console.log(e);",
          "}",
          ""
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "method": "POST",
    "header": [
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n    \"content\": {\n        \"@odata.type\": \"#microsoft.graph.windowsUpdates.featureUpdateReference\",\n        \"version\": \"{{FeatureUpdateVersion}}\"\n    },\n    \"settings\": {\n        \"@odata.type\": \"microsoft.graph.windowsUpdates.windowsDeploymentSettings\",\n        \"rollout\": {\n            \"devicesPerOffer\": 100,\n            \"durationBetweenOffers\": \"P7D\"\n        },\n        \"monitoring\": {\n            \"monitoringRules\": [\n                {\n                    \"@odata.type\": \"#microsoft.graph.windowsUpdates.monitoringRule\",\n                    \"signal\": \"rollback\",\n                    \"threshold\": 5,\n                    \"action\": \"pauseDeployment\"\n                }\n            ]\n        }\n    }\n}",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "https://graph.microsoft.com/beta/admin/windows/updates/deployments",
      "protocol": "https",
      "host": [
        "graph",
        "microsoft",
        "com"
      ],
      "path": [
        "beta",
        "admin",
        "windows",
        "updates",
        "deployments"
      ]
    }
  },
  "response": [
  ]
}