runtime: Only require 'pid' in the state for created/running statuses

Because during the 'creating' phase we may not have a container
process yet (e.g. if we're still reading the configuration or setting
up cgroups), and in the 'stopped' phase the PID is no longer
meaningful.

Signed-off-by: W. Trevor King <[email protected]>

Author: wking

runtime.md

@@ -7,26 +7,28 @@ Whether other entities using the same, or other, instance of the runtime can see
 
 ## State
 
-The state of a container MUST include, at least, the following properties:
+The state of a container includes the following properties:
 
-* **`ociVersion`**: (string) is the OCI specification version used when creating the container.
-* **`id`**: (string) is the container's ID.
+* **`ociVersion`** (string, required) is the OCI specification version used when creating the container.
+* **`id`** (string, required) is the container's ID.
 This MUST be unique across all containers on this host.
 There is no requirement that it be unique across hosts.
-* **`status`**: (string) is the runtime state of the container.
+* **`status`** (string, required) is the runtime state of the container.
 The value MAY be one of:
   * `creating` : the container is being created (step 2 in the [lifecycle](#lifecycle))
   * `created` : the runtime has finished the [create operation](#create) (after step 2 in the [lifecycle](#lifecycle)), and the container process has neither exited nor executed the user-specified code
   * `running` : the container process has executed the user-specified code but has not exited (after step 4 in the [lifecycle](#lifecycle))
   * `stopped` : the container process has exited (step 5 in the [lifecycle](#lifecycle))
 
   Additional values MAY be defined by the runtime, however, they MUST be used to represent new runtime states not defined above.
-* **`pid`**: (int) is the ID of the main process within the container, as seen by the host.
-* **`bundlePath`**: (string) is the absolute path to the container's bundle directory.
+* **`pid`** (int, required when `status` is `created` or `running`) is the ID of the main process within the container, as seen by the host.
+* **`bundlePath`**: (string, required) is the absolute path to the container's bundle directory.
 This is provided so that consumers can find the container's configuration and root filesystem on the host.
-* **`annotations`**: (map) contains the list of annotations associated with the container.
+* **`annotations`**: (map, required) contains the list of annotations associated with the container.
 If no annotations were provided then this property MAY either be absent or an empty map.
 
+The state MAY include additional properties.
+
 When serialized in JSON, the format MUST adhere to the following pattern:
 
 ```json