restic/vendor/google.golang.org/api/oslogin/v1beta/oslogin-api.json

{
  "basePath": "",
  "revision": "20171120",
  "documentationLink": "https://cloud.google.com/compute/docs/oslogin/rest/",
  "id": "oslogin:v1beta",
  "discoveryVersion": "v1",
  "version_module": true,
  "schemas": {
    "Empty": {
      "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n    service Foo {\n      rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n    }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
      "type": "object",
      "properties": {},
      "id": "Empty"
    },
    "SshPublicKey": {
      "description": "The SSH public key information associated with a Google account.",
      "type": "object",
      "properties": {
        "expirationTimeUsec": {
          "description": "An expiration time in microseconds since epoch.",
          "format": "int64",
          "type": "string"
        },
        "fingerprint": {
          "description": "Output only. The SHA-256 fingerprint of the SSH public key.",
          "type": "string"
        },
        "key": {
          "description": "Public key text in SSH format, defined by\n\u003ca href=\"https://www.ietf.org/rfc/rfc4253.txt\" target=\"_blank\"\u003eRFC4253\u003c/a\u003e\nsection 6.6.",
          "type": "string"
        }
      },
      "id": "SshPublicKey"
    },
    "ImportSshPublicKeyResponse": {
      "description": "A response message for importing an SSH public key.",
      "type": "object",
      "properties": {
        "loginProfile": {
          "$ref": "LoginProfile",
          "description": "The login profile information for the user."
        }
      },
      "id": "ImportSshPublicKeyResponse"
    },
    "PosixAccount": {
      "description": "The POSIX account information associated with a Google account.",
      "type": "object",
      "properties": {
        "primary": {
          "description": "Only one POSIX account can be marked as primary.",
          "type": "boolean"
        },
        "accountId": {
          "description": "Output only. A POSIX account identifier.",
          "type": "string"
        },
        "gid": {
          "description": "The default group ID.",
          "format": "int64",
          "type": "string"
        },
        "uid": {
          "description": "The user ID.",
          "format": "int64",
          "type": "string"
        },
        "username": {
          "description": "The username of the POSIX account.",
          "type": "string"
        },
        "shell": {
          "description": "The path to the logic shell for this account.",
          "type": "string"
        },
        "homeDirectory": {
          "description": "The path to the home directory for this account.",
          "type": "string"
        },
        "systemId": {
          "description": "System identifier for which account the username or uid applies to.\nBy default, the empty value is used.",
          "type": "string"
        },
        "gecos": {
          "description": "The GECOS (user information) entry for this account.",
          "type": "string"
        }
      },
      "id": "PosixAccount"
    },
    "LoginProfile": {
      "description": "The user profile information used for logging in to a virtual machine on\nGoogle Compute Engine.",
      "type": "object",
      "properties": {
        "name": {
          "description": "The primary email address that uniquely identifies the user.",
          "type": "string"
        },
        "posixAccounts": {
          "description": "The list of POSIX accounts associated with the user.",
          "type": "array",
          "items": {
            "$ref": "PosixAccount"
          }
        },
        "suspended": {
          "description": "Indicates if the user is suspended. A suspended user cannot log in but\ntheir profile information is retained.",
          "type": "boolean"
        },
        "sshPublicKeys": {
          "description": "A map from SSH public key fingerprint to the associated key object.",
          "type": "object",
          "additionalProperties": {
            "$ref": "SshPublicKey"
          }
        }
      },
      "id": "LoginProfile"
    }
  },
  "protocol": "rest",
  "icons": {
    "x16": "http://www.google.com/images/icons/product/search-16.gif",
    "x32": "http://www.google.com/images/icons/product/search-32.gif"
  },
  "canonicalName": "Cloud OS Login",
  "auth": {
    "oauth2": {
      "scopes": {
        "https://www.googleapis.com/auth/cloud-platform.read-only": {
          "description": "View your data across Google Cloud Platform services"
        },
        "https://www.googleapis.com/auth/cloud-platform": {
          "description": "View and manage your data across Google Cloud Platform services"
        },
        "https://www.googleapis.com/auth/compute.readonly": {
          "description": "View your Google Compute Engine resources"
        },
        "https://www.googleapis.com/auth/compute": {
          "description": "View and manage your Google Compute Engine resources"
        }
      }
    }
  },
  "rootUrl": "https://oslogin.googleapis.com/",
  "ownerDomain": "google.com",
  "name": "oslogin",
  "batchPath": "batch",
  "fullyEncodeReservedExpansion": true,
  "title": "Google Cloud OS Login API",
  "ownerName": "Google",
  "resources": {
    "users": {
      "methods": {
        "importSshPublicKey": {
          "flatPath": "v1beta/users/{usersId}:importSshPublicKey",
          "path": "v1beta/{+parent}:importSshPublicKey",
          "id": "oslogin.users.importSshPublicKey",
          "description": "Adds an SSH public key and returns the profile information. Default POSIX\naccount information is set when no username and UID exist as part of the\nlogin profile.",
          "request": {
            "$ref": "SshPublicKey"
          },
          "response": {
            "$ref": "ImportSshPublicKeyResponse"
          },
          "parameterOrder": [
            "parent"
          ],
          "httpMethod": "POST",
          "scopes": [
            "https://www.googleapis.com/auth/cloud-platform",
            "https://www.googleapis.com/auth/compute"
          ],
          "parameters": {
            "projectId": {
              "description": "The project ID of the Google Cloud Platform project.",
              "type": "string",
              "location": "query"
            },
            "parent": {
              "description": "The unique ID for the user in format `users/{user}`.",
              "required": true,
              "type": "string",
              "pattern": "^users/[^/]+$",
              "location": "path"
            }
          }
        },
        "getLoginProfile": {
          "description": "Retrieves the profile information used for logging in to a virtual machine\non Google Compute Engine.",
          "response": {
            "$ref": "LoginProfile"
          },
          "parameterOrder": [
            "name"
          ],
          "httpMethod": "GET",
          "scopes": [
            "https://www.googleapis.com/auth/cloud-platform",
            "https://www.googleapis.com/auth/cloud-platform.read-only",
            "https://www.googleapis.com/auth/compute",
            "https://www.googleapis.com/auth/compute.readonly"
          ],
          "parameters": {
            "name": {
              "description": "The unique ID for the user in format `users/{user}`.",
              "required": true,
              "type": "string",
              "pattern": "^users/[^/]+$",
              "location": "path"
            }
          },
          "flatPath": "v1beta/users/{usersId}/loginProfile",
          "path": "v1beta/{+name}/loginProfile",
          "id": "oslogin.users.getLoginProfile"
        }
      },
      "resources": {
        "sshPublicKeys": {
          "methods": {
            "delete": {
              "flatPath": "v1beta/users/{usersId}/sshPublicKeys/{sshPublicKeysId}",
              "id": "oslogin.users.sshPublicKeys.delete",
              "path": "v1beta/{+name}",
              "description": "Deletes an SSH public key.",
              "httpMethod": "DELETE",
              "parameterOrder": [
                "name"
              ],
              "response": {
                "$ref": "Empty"
              },
              "parameters": {
                "name": {
                  "description": "The fingerprint of the public key to update. Public keys are identified by\ntheir SHA-256 fingerprint. The fingerprint of the public key is in format\n`users/{user}/sshPublicKeys/{fingerprint}`.",
                  "required": true,
                  "type": "string",
                  "pattern": "^users/[^/]+/sshPublicKeys/[^/]+$",
                  "location": "path"
                }
              },
              "scopes": [
                "https://www.googleapis.com/auth/cloud-platform",
                "https://www.googleapis.com/auth/compute"
              ]
            },
            "get": {
              "description": "Retrieves an SSH public key.",
              "response": {
                "$ref": "SshPublicKey"
              },
              "parameterOrder": [
                "name"
              ],
              "httpMethod": "GET",
              "parameters": {
                "name": {
                  "description": "The fingerprint of the public key to retrieve. Public keys are identified\nby their SHA-256 fingerprint. The fingerprint of the public key is in\nformat `users/{user}/sshPublicKeys/{fingerprint}`.",
                  "required": true,
                  "type": "string",
                  "pattern": "^users/[^/]+/sshPublicKeys/[^/]+$",
                  "location": "path"
                }
              },
              "scopes": [
                "https://www.googleapis.com/auth/cloud-platform",
                "https://www.googleapis.com/auth/compute"
              ],
              "flatPath": "v1beta/users/{usersId}/sshPublicKeys/{sshPublicKeysId}",
              "path": "v1beta/{+name}",
              "id": "oslogin.users.sshPublicKeys.get"
            },
            "patch": {
              "description": "Updates an SSH public key and returns the profile information. This method\nsupports patch semantics.",
              "request": {
                "$ref": "SshPublicKey"
              },
              "response": {
                "$ref": "SshPublicKey"
              },
              "parameterOrder": [
                "name"
              ],
              "httpMethod": "PATCH",
              "scopes": [
                "https://www.googleapis.com/auth/cloud-platform",
                "https://www.googleapis.com/auth/compute"
              ],
              "parameters": {
                "updateMask": {
                  "description": "Mask to control which fields get updated. Updates all if not present.",
                  "format": "google-fieldmask",
                  "type": "string",
                  "location": "query"
                },
                "name": {
                  "location": "path",
                  "description": "The fingerprint of the public key to update. Public keys are identified by\ntheir SHA-256 fingerprint. The fingerprint of the public key is in format\n`users/{user}/sshPublicKeys/{fingerprint}`.",
                  "required": true,
                  "type": "string",
                  "pattern": "^users/[^/]+/sshPublicKeys/[^/]+$"
                }
              },
              "flatPath": "v1beta/users/{usersId}/sshPublicKeys/{sshPublicKeysId}",
              "path": "v1beta/{+name}",
              "id": "oslogin.users.sshPublicKeys.patch"
            }
          }
        },
        "projects": {
          "methods": {
            "delete": {
              "description": "Deletes a POSIX account.",
              "response": {
                "$ref": "Empty"
              },
              "parameterOrder": [
                "name"
              ],
              "httpMethod": "DELETE",
              "parameters": {
                "name": {
                  "location": "path",
                  "description": "A reference to the POSIX account to update. POSIX accounts are identified\nby the project ID they are associated with. A reference to the POSIX\naccount is in format `users/{user}/projects/{project}`.",
                  "required": true,
                  "type": "string",
                  "pattern": "^users/[^/]+/projects/[^/]+$"
                }
              },
              "scopes": [
                "https://www.googleapis.com/auth/cloud-platform",
                "https://www.googleapis.com/auth/compute"
              ],
              "flatPath": "v1beta/users/{usersId}/projects/{projectsId}",
              "path": "v1beta/{+name}",
              "id": "oslogin.users.projects.delete"
            }
          }
        }
      }
    }
  },
  "parameters": {
    "callback": {
      "location": "query",
      "description": "JSONP",
      "type": "string"
    },
    "$.xgafv": {
      "description": "V1 error format.",
      "type": "string",
      "enumDescriptions": [
        "v1 error format",
        "v2 error format"
      ],
      "location": "query",
      "enum": [
        "1",
        "2"
      ]
    },
    "alt": {
      "enumDescriptions": [
        "Responses with Content-Type of application/json",
        "Media download with context-dependent Content-Type",
        "Responses with Content-Type of application/x-protobuf"
      ],
      "location": "query",
      "description": "Data format for response.",
      "default": "json",
      "enum": [
        "json",
        "media",
        "proto"
      ],
      "type": "string"
    },
    "access_token": {
      "location": "query",
      "description": "OAuth access token.",
      "type": "string"
    },
    "key": {
      "location": "query",
      "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
      "type": "string"
    },
    "quotaUser": {
      "location": "query",
      "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
      "type": "string"
    },
    "pp": {
      "description": "Pretty-print response.",
      "type": "boolean",
      "default": "true",
      "location": "query"
    },
    "bearer_token": {
      "location": "query",
      "description": "OAuth bearer token.",
      "type": "string"
    },
    "oauth_token": {
      "location": "query",
      "description": "OAuth 2.0 token for the current user.",
      "type": "string"
    },
    "upload_protocol": {
      "location": "query",
      "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
      "type": "string"
    },
    "prettyPrint": {
      "location": "query",
      "description": "Returns response with indentations and line breaks.",
      "type": "boolean",
      "default": "true"
    },
    "fields": {
      "location": "query",
      "description": "Selector specifying which fields to include in a partial response.",
      "type": "string"
    },
    "uploadType": {
      "location": "query",
      "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
      "type": "string"
    }
  },
  "version": "v1beta",
  "baseUrl": "https://oslogin.googleapis.com/",
  "servicePath": "",
  "description": "Manages OS login configuration for Google account users.",
  "kind": "discovery#restDescription"
}